home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cos150.zip / COSWORTH.DOC next >
Text File  |  1992-10-07  |  236KB  |  6,007 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.    ╔═════════════════════════════════════════════════════════════════════╗
  15.    ║                                                                     ║
  16.    ║ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓ ▓▓  ▓▓  ▓▓ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓▓ ▓▓   ▓▓ ║
  17.    ║ ▓▓      ▓▓   ▓▓ ▓▓      ▓▓  ▓▓  ▓▓ ▓▓   ▓▓ ▓▓   ▓▓    ▓▓    ▓▓   ▓▓ ║
  18.    ║ ▓▓      ▓▓   ▓▓ ▓▓      ▓▓  ▓▓  ▓▓ ▓▓   ▓▓ ▓▓   ▓▓    ▓▓    ▓▓   ▓▓ ║
  19.    ║ ▓▓      ▓▓   ▓▓ ▓▓▓▓▓▓▓ ▓▓  ▓▓  ▓▓ ▓▓   ▓▓ ▓▓▓▓▓▓▓    ▓▓    ▓▓▓▓▓▓▓ ║
  20.    ║ ▓▓      ▓▓   ▓▓      ▓▓ ▓▓  ▓▓  ▓▓ ▓▓   ▓▓ ▓▓  ▓▓     ▓▓    ▓▓   ▓▓ ║
  21.    ║ ▓▓      ▓▓   ▓▓      ▓▓  ▓▓▓▓▓▓▓▓  ▓▓   ▓▓ ▓▓  ▓▓     ▓▓    ▓▓   ▓▓ ║
  22.    ║ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓   ▓▓  ▓▓   ▓▓▓▓▓▓▓ ▓▓   ▓▓    ▓▓    ▓▓   ▓▓ ║
  23.    ║                                                                     ║
  24.    ╚═════════════════════════════════════════════════════════════════════╝
  25.  
  26.                        COSWORTH COMMUNICATIONS SOFTWARE
  27.                                  Version 1.50
  28.                (c) D.Carroll, M.Dickson  Opus Programs 1992
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                        COSWORTH COMMUNICATIONS SOFTWARE
  77.                                  Version 1.50
  78.                (c) D.Carroll, M.Dickson  Opus Programs 1992
  79.  
  80.  
  81.  
  82.  
  83.     TABLE OF CONTENTS
  84.     -----------------
  85.  
  86.     Copyright Notice and Disclaimer..............................page 3
  87.     Introduction.................................................page 4
  88.     Installing Cosworth..........................................page 7
  89.     Command Line Switches........................................page 12
  90.     Configuring Cosworth.........................................page 14
  91.     The Dialling Directory.......................................page 28
  92.     Script Files.................................................page 44
  93.     Keystroke Macros.............................................page 54
  94.     Auto Dialler.................................................page 57
  95.     Terminal Mode................................................page 66
  96.     Ancillary Files..............................................page 69
  97.     About Cosworth...............................................page 71
  98.  
  99.     Appendix One - Troubleshooting...............................page 72
  100.     Appendix Two - Error Messages................................page 75
  101.     Appendix Three - XCos File Transfer Protocol.................page 83
  102.     Appendix Four - Glossary.....................................page 87
  103.     Appendix Five - Acknowledgements.............................page 91
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                        COPYRIGHT NOTICE AND DISCLAIMER
  140.  
  141.     COSWORTH is not "public domain" software. It is distributed as
  142.     "freeware", whose meaning is that although no charge is made by Opus
  143.     Programs for this present version, sole and exclusive copyright and
  144.     ownership of COSWORTH is retained by Opus Programs.
  145.  
  146.     Opus Programs grant you, without charge, the right to reproduce,
  147.     distribute and use this version of COSWORTH on the express condition
  148.     that you do not receive any payment, commercial benefit or other
  149.     consideration for any such act, and that the wording of this copyright
  150.     notice and disclaimer is not changed in any way within the
  151.     documentation, software or magnetic media.
  152.  
  153.     This product is licensed 'as is' without any warranty of fitness for a
  154.     particular purpose, performance or otherwise. All warranties are
  155.     expressly disclaimed. By using COSWORTH you agree that neither Opus
  156.     Programs nor any related parties will be liable to you or any third
  157.     party for any use of (or inability to use) or performance of this
  158.     product, any damages whatsoever incurred by the use of this product OR
  159.     ANY FINANCIAL LIABILITY INCURRED BY THE USE OF THIS PRODUCT, even if
  160.     such possibilities are mentioned in advance.
  161.  
  162.     In particular, we wish to draw your attention to the Auto Dialler
  163.     procedure found within COSWORTH. This process allows the unattended
  164.     dialling and connection by telephone line communication to a remote
  165.     system or computer. This facility is employed entirely at the users
  166.     own risk and Opus Programs will neither incur nor bear nor sustain any
  167.     financial damages or limitations of any nature as a result.
  168.  
  169.     The rights to modify COSWORTH or employ its component parts in any
  170.     other work are exclusively retained by Opus Programs. You may not
  171.     reverse-engineer, disassemble, modify, decompile or create derivative
  172.     works of this product. You also acknowledge that COSWORTH remains the
  173.     intellectual property of Opus Programs.
  174.  
  175.     By using COSWORTH you give your express agreement to the above
  176.     copyright and disclaimer notice.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.     INTRODUCTION
  206.     ------------
  207.  
  208.     Thank you for using COSWORTH Communications Software.
  209.  
  210.     COSWORTH is a multi-featured communications software package
  211.     containing many features common to a number of other comms
  212.     applications, together with a number of additional features which no
  213.     one seems to have thought of yet, as far as we know! It was really
  214.     written by us since we couldn't find another comms package that had
  215.     all the features in it we wanted. This being the case, it has been
  216.     written by two users FOR other users. We hope this fact comes through
  217.     in the software. The main features of COSWORTH are;
  218.  
  219.          - COSWORTH is issued as FREEWARE. No payment is expected to be
  220.            made by anyone using the software. As far as we are aware, this
  221.            is a first for comms software of any substance.
  222.  
  223.          - It directly supports connections through Mercury
  224.            Communications.
  225.  
  226.          - Has a full featured yet simple script language which is read
  227.            from standard ASCII text files created on just about any text
  228.            editor. In addition, script files can be automatically
  229.            'learned' by COSWORTH itself. Even if your script file 'goes
  230.            wrong', a 'smart script' feature will automatically attempt to
  231.            correct the situation!
  232.  
  233.          - Has an 'Auto Dialler' facility which allows unattended dialling
  234.            using a built-in timer, together with a number of 'safety
  235.            features' which ensure that you aren't on line any longer than
  236.            you wish.
  237.  
  238.          - Up to twenty user-defined keystroke macros featuring an
  239.            internal delay facility.
  240.  
  241.          - Support for the FIFO 16550A UART chip.
  242.  
  243.          - When executing an external program (either a DOS session or an
  244.            external file transfer protocol program) then COSWORTH will
  245.            swap its code out to Expanded Memory, Extended Memory or Disk,
  246.            allowing far more available memory for the child program.
  247.            Typically, COSWORTH leaves less that 5K of itself in
  248.            conventional memory.
  249.  
  250.          - Configuration of up to twenty external file transfer protocols,
  251.            five dialling prefixes and up to one hundred entries in each
  252.            dialling directory.
  253.  
  254.          - Full internal ANSI emulation.
  255.  
  256.          - Automatic deletion of user-defined files once uploaded.
  257.  
  258.          - Automatic modem detection on serial port.
  259.  
  260.  
  261.  
  262.     COSWORTH COMMUNICATIONS SOFTWARE - Introduction                 page 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.          - Supports a wide variety of baud rates from 300 up to 38400
  272.            baud.
  273.  
  274.          - An easy to use installation program which creates all the
  275.            necessary support files as well as specific Microsoft Windows 3
  276.            PIF files and icons. It also detects whether you are running JP
  277.            Software's 4DOS and modifies the installation accordingly. It
  278.            even writes out a batch file onto your PATH so you can run
  279.            COSWORTH from any directory!
  280.  
  281.          - Complete Quarterdeck DESQview awareness.
  282.  
  283.          - Context-sensitive help.
  284.  
  285.     There are other features but you'll see them as you go along!
  286.  
  287.  
  288.     HARDWARE REQUIREMENTS AND ADDITIONAL SET UP INFORMATION
  289.     -------------------------------------------------------
  290.  
  291.     In order to run COSWORTH you will require an IBM PC, XT, AT, PS/2 or
  292.     true compatible with a hard disk with at least 500K of free space.
  293.  
  294.     However, like other communications software systems, COSWORTH gives
  295.     you the ability to download files from remote systems and, as such,
  296.     will almost certainly require more free storage space.
  297.  
  298.     When COSWORTH executes an external program, either a DOS shell or an
  299.     external protocol, it swaps itself out to EMS, XMS or disk (in that
  300.     order) to allow more memory for the child process called. If there is
  301.     no EMS or XMS then COSWORTH will revert to dumping the memory contents
  302.     of your PC out to disk and then reload it when the child process has
  303.     been completed. If your PC only has floppy drives then you will almost
  304.     certainly find that COSWORTH will not be able to run external programs
  305.     since there will be insufficient disk space to create the memory dump
  306.     file. If COSWORTH has to swap itself out to disk then it will attempt
  307.     to place the swap file in the directory specified by the MSDOS
  308.     environment variable TEMP. If this variable has not been declared then
  309.     the swap file will be created in the root directory of the current
  310.     disk. As a result, you *may* be able to get away with running COSWORTH
  311.     on a dual floppy drive with the TEMP variable pointing to the second
  312.     disk drive, although any program executions will necessarily be very
  313.     slow due to the greatly reduced access speeds on floppy drives.
  314.     However, the authors do not regard this as a major drawback as disk
  315.     space must already be available for a file download. For this reason,
  316.     we recommend COSWORTH is run from a hard disk.
  317.  
  318.     COSWORTH also requires a machine with *at least* 512K RAM after DOS
  319.     has been loaded. In order to run some external protocol programs or a
  320.     DOS shell, extra memory up to the full 640K level would be an
  321.     advantage. COSWORTH supports up to a maximum of four serial ports
  322.     (COM1, COM2, COM3 and COM4), as many disk drives as you can fit to
  323.     your machine and a parallel printer.
  324.  
  325.  
  326.  
  327.  
  328.     COSWORTH COMMUNICATIONS SOFTWARE - Introduction                 page 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.     You will also require a modem with certain capabilities. The modem
  338.     must not operate with a forced (high) Carrier Detect signal and must
  339.     not override or ignore the Data Terminal Ready signal either. Baud
  340.     rates between 300 baud to 38400 baud are supported.
  341.  
  342.  
  343.     ASSISTANCE
  344.     ----------
  345.  
  346.     If you require any assistance in using COSWORTH then contact ALMAC
  347.     bulletin board in Scotland on 0324-665371 (Running PC Board BBS, 24
  348.     hours a day) where both authors can be found regularly. The authors
  349.     may also be contacted on the Ilink International Echomail system in
  350.     the SHAREWARE conference or through Usenet on mike.dickson@almac.co.uk
  351.     or derek.carroll@almac.co.uk. Any suggestions for future versions of
  352.     the software will be gratefully received.
  353.  
  354.     We hope you enjoy using COSWORTH.
  355.  
  356.     Mike Dickson
  357.     Derek Carroll
  358.     Opus Programs, 1992
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.     COSWORTH COMMUNICATIONS SOFTWARE - Introduction                 page 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.     INSTALLING COSWORTH
  404.     -------------------
  405.  
  406.     When you receive COSWORTH it is most likely that you have either
  407.     obtained it from a friend or have downloaded it from a Bulletin Board
  408.     (using inferior comms software, of course!) in a compressed archive
  409.     format.
  410.  
  411.     It's assumed that you have unpacked this archive file by now (after
  412.     all, how else would you be reading this?) and have the following
  413.     files;
  414.  
  415.        COSWORTH.EXE - The main program
  416.        COSWORTH.DOC - This file
  417.        XCOS.EXE     - An Xmodem protocol written specially for COSWORTH
  418.        INSTALL.EXE  - The COSWORTH installation program
  419.        READ.ME      - Installation information
  420.  
  421.     You will not be able to run COSWORTH without first running
  422.     INSTALL.EXE. If you try this, be prepared to experience some
  423.     interesting error messages! INSTALL asks you some simple questions
  424.     about your telephone service, your modem and your computer and will
  425.     detect a few things about your hardware. It will then write out all
  426.     the files that COSWORTH requires into the appropriate subdirectories.
  427.  
  428.     Installation of COSWORTH is entirely automated. To install, first
  429.     create a subdirectory in which you wish to store COSWORTH. (We use and
  430.     recommend \COSWORTH off the root directory but you could put it
  431.     anywhere!) The DOS command to do this is
  432.  
  433.                                  MD \COSWORTH
  434.  
  435.     Then, copy all the above files into that directory with
  436.  
  437.                               COPY *.* \COSWORTH
  438.  
  439.     and then change to that directory with
  440.  
  441.                                 CD \COSWORTH.
  442.  
  443.     Now that you are 'in' the COSWORTH directory, run INSTALL.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.     COSWORTH COMMUNICATIONS SOFTWARE - Installing Cosworth          page 7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.     THE INSTALLATION PROGRAM
  470.     ------------------------
  471.  
  472.     The first thing that appears is a text window telling you what is
  473.     about to happen...
  474.  
  475.   ╔════════════════════╣ COSWORTH Installation Program ╠════════════════════╗
  476.   ║                                                                         ║
  477.   ║              WELCOME TO THE COSWORTH INSTALLATION SERVICE               ║
  478.   ║                                                                         ║
  479.   ║     This program will request you to enter the DOS directories that     ║
  480.   ║     COSWORTH will use, as well as some basic information regarding      ║
  481.   ║       your telephone service. It will create any directories you        ║
  482.   ║     specify that do not already exist and will create some example      ║
  483.   ║      files in the process. It will also create a batch file called      ║
  484.   ║       COSWORTH.BAT which will be placed in the first directory in       ║
  485.   ║     your DOS PATH and which will allow COSWORTH to be run from any      ║
  486.   ║      directory. This program will neither examine nor modify your       ║
  487.   ║                         CONFIG.SYS system file.                         ║
  488.   ║                                                                         ║
  489.   ╚═══════════════════════╣ ESC ABORTS INSTALLATION ╠═══════════════════════╝
  490.  
  491.     Notice the bit about COSWORTH 'neither examining nor modifying your
  492.     CONFIG.SYS system file.' It's important to realise that this is a
  493.     well-behaved installation program which doesn't go tampering with
  494.     things it really ought to leave well alone. However, a recommendation
  495.     is to include AT LEAST 20 file handles in your CONFIG.SYS file with
  496.     the directive
  497.  
  498.                                    FILES=20
  499.  
  500.     at some point within it. Any fewer than this and COSWORTH may
  501.     experience problems opening all file handles it requires. If you don't
  502.     have this line (at least) in your CONFIG.SYS then it's a good idea to
  503.     include it anyway.
  504.  
  505.     Pressing any key takes you onto the next screen. This screen asks you
  506.     to enter the names of all the DOS directories where COSWORTH will
  507.     store and look for files...
  508.  
  509.     ╔══════════════════════╣ COSWORTH Installation ╠══════════════════════╗
  510.     ║                                                                     ║
  511.     ║    Please specify the directories for installation of COSWORTH      ║
  512.     ║                                                                     ║
  513.     ║ MAIN DIRECTORY     C:\COSWORTH                                      ║
  514.     ║ UPLOAD DIRECTORY   C:\COSWORTH\UPLOAD..........................     ║
  515.     ║ DOWNLOAD DIRECTORY C:\COSWORTH\DOWNLOAD........................     ║
  516.     ║ SCRIPT DIRECTORY   C:\COSWORTH\SCRIPTS.........................     ║
  517.     ║ PROTOCOL DIRECTORY C:\COSWORTH\PROTOCOL........................     ║
  518.     ║                                                                     ║
  519.     ║            This is where file uploads will be made from             ║
  520.     ║                                                                     ║
  521.     ║                                                                     ║
  522.     ╚══════════════╣ F10 TO SAVE, ESC ABORTS INSTALLATION ╠═══════════════╝
  523.  
  524.  
  525.  
  526.     COSWORTH COMMUNICATIONS SOFTWARE - Installing Cosworth          page 8
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.     You can move the highlight bar up and down using the arrow keys and
  536.     can edit the names of the directories as you wish. The entries are
  537.     already filled in with default values and we recommend you do not
  538.     change them unless you have good reason to. The entry for MAIN
  539.     DIRECTORY will reflect the current directory and cannot be changed.
  540.  
  541.     Once you are happy with the directories, press F10 to continue. ESC
  542.     aborts the installation process completely. If you press F10 then up
  543.     comes the next screen...
  544.  
  545.   ╔════════════════════════╣ COSWORTH Installation ╠════════════════════════╗
  546.   ║                                                                         ║
  547.   ║                                                                         ║
  548.   ║    What is the fastest baud rate your modem supports?                   ║
  549.   ║    300 1200 2400 4800 9600 14400 19200 38400 57600                      ║
  550.   ║    Does your exchange support tone or pulse dialling?  Tone Pulse       ║
  551.   ║    What serial port is your modem connected to?  COM1 COM2 COM3 COM4    ║
  552.   ║    What's your name? JOE BLOGGS........................................ ║
  553.   ║    Are you a Mercury subscriber?    YES    NO                           ║
  554.   ║    Enter your Mercury code 131,1234567890......                         ║
  555.   ║    (with prefix - eg 131,1234567890)                                    ║
  556.   ║                                                                         ║
  557.   ║                                                                         ║
  558.   ╚═══════════════════════╣ ESC ABORTS INSTALLATION ╠═══════════════════════╝
  559.  
  560.     The questions will appear one at a time from the top of the screen, as
  561.     you answer them. The first three are of a 'multiple choice' variety
  562.     and require you to choose one of the responses on the screen by moving
  563.     the highlight block along the screen with the left or right arrow
  564.     keys.
  565.  
  566.     The fastest baud rate your modem supports will be given in your
  567.     modem's manual.
  568.  
  569.     If you are unsure whether you have tone or pulse dialling, choose
  570.     pulse. (Tone dialling plays 'notes' for every number you dial on your
  571.     telephone)
  572.  
  573.     You'll need to enter your name in order to let COSWORTH use it in its
  574.     script files (more of which later!)
  575.  
  576.     If you subscribe to Mercury Communications then you can set up
  577.     COSWORTH to use the cheaper Mercury connections. In order to connect
  578.     with Mercury, you'll have to let COSWORTH know what your authorisation
  579.     number is. Enter it in this box. You'll also have to enter the
  580.     preceding code (which is 131 at the time of writing) and maybe a
  581.     separating comma (,) to pause the modem prior to sending out your
  582.     personal code. If you don't subscribe to Mercury then enter 'N' at the
  583.     'Are you a Mercury subscriber? (Y/N)' prompt.
  584.  
  585.     Once you have completed all these questions, INSTALL will go ahead and
  586.     create all the directories (if it has to) and files that you have
  587.     specified and that it requires. If INSTALL encounters any problems
  588.     then it will abort with an error message, telling you which action to
  589.     take.
  590.  
  591.  
  592.     COSWORTH COMMUNICATIONS SOFTWARE - Installing Cosworth          page 9
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.     Once INSTALL has run its course it will flash up a small message
  602.     advising you as to what has happened. INSTALL will create the
  603.     following files (following on from our sample default directory
  604.     structure)...
  605.  
  606.     DOWNLOAD     - The directory into which files will be received.
  607.     UPLOAD       - The directory from which files will be sent.
  608.     PROTOCOL     - The directory where you will put your external
  609.                    protocol programs.
  610.     SCRIPTS      - The directory where your script files are stored and
  611.                    read from.
  612.  
  613.     COSWORTH.ICO - COSWORTH icon for Microsoft Windows
  614.     COSAUTO.ICO  - COSWORTH Auto Dialler icon for Microsoft Windows
  615.     COSWORTH.PIF - COSWORTH Program Information File for Microsoft Windows
  616.     COSCOST.ICO  - COSCOST icon for Microsoft Windows
  617.     CW-PIF.DVP   - COSWORTH Program Information File for DESQview
  618.  
  619.     COSWORTH.CFG - COSWORTH configuration file
  620.  
  621.     COSWORTH.CAP - COSWORTH capture file
  622.     COSWORTH.ERF - COSWORTH error file
  623.     COSWORTH.LOG - COSWORTH log file
  624.     COSWORTH.MAC - COSWORTH macro file
  625.     COSWORTH.PHN - COSWORTH dialling directory
  626.     COSWORTH.PTL - COSWORTH protocol definition
  627.     COSWORTH.SNP - COSWORTH snapshot file
  628.  
  629.     The SCRIPT directory will contain the following files...
  630.  
  631.     ALMAC.SPT    - COSWORTH script for Almac BBS
  632.     EAZIHOST.SPT - COSWORTH script for Eazihost BBS's
  633.     MISSPOSS.SPT - COSWORTH script for Mission Impossible
  634.     OPUS.SPT     - COSWORTH script for Opus BBS's
  635.     PC-BOARD.SPT - COSWORTH script for PC-Board BBS's
  636.     REMOTEAC.SPT - COSWORTH script for Remote Access BBS's
  637.     PISTON.SPT   - COSWORTH script for Piston Poppers BBS
  638.     BLUELBL.SPT  - COSWORTH script for Blue Label BBS
  639.  
  640.     In addition, INSTALL will trace your operating system PATH and will
  641.     pick out the first directory in it. It will then write out a DOS
  642.     batch file into that directory called COS.BAT which will allow you to
  643.     run COSWORTH from any directory on your disk.
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.     COSWORTH COMMUNICATIONS SOFTWARE - Installing Cosworth          page 10
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.     COSWORTH will also detect whether you are running JP Software's
  668.     excellent 4DOS and will DESCRIBE (a 4DOS command) all the files and
  669.     directories it creates, as well as writing out COS.BTM instead of
  670.     COS.BAT. The contents of the batch files are as follows...
  671.  
  672.     COS.BAT (for MS-DOS)
  673.  
  674.             @Echo Off
  675.             REM Batch file to launch COSWORTH
  676.             CD C:\COSWORTH
  677.             COSWORTH.EXE %1 %2 %3 %4 %5
  678.  
  679.     COS.BTM (for 4DOS)
  680.  
  681.             @Echo Off
  682.             REM Batch file to launch COSWORTH
  683.             PushD
  684.             Cdd C:\COSWORTH
  685.             COSWORTH.EXE %1 %2 %3 %4 %5
  686.             PopD
  687.  
  688.  
  689.     And that's it! From now on, just run
  690.  
  691.                                      COS
  692.  
  693.     followed by any command line arguments you need from the DOS command
  694.     line and you're away!
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.     COSWORTH COMMUNICATIONS SOFTWARE - Installing Cosworth          page 11
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.     COMMAND LINE SWITCHES FOR STARTING UP COSWORTH
  734.     ----------------------------------------------
  735.  
  736.     There are three command line switches which can be used in starting up
  737.     COSWORTH. These are;
  738.  
  739.     AUTO <=FileName> - Invoke Auto Dialling facility straight away without
  740.                        running through menus. You may wish to use this
  741.                        switch if you are planning on Auto Dialling more
  742.                        than 24 hours in advance and are using a time
  743.                        switch or other software to do so, or if you wish
  744.                        to Auto Dial over several control files. The
  745.                        argument <=FileName> is used to cause COSWORTH to
  746.                        Auto Dial using whatever Auto Dialler Control File
  747.                        is specified. The '.AUT' extension is optional. If
  748.                        the file name is not specified then the file
  749.                        COSWORTH.AUT is used.
  750.  
  751.                        For example, to AUto Dial from the command line
  752.                        using the LONGDIST.PHN Dialling Directory you would
  753.                        use the command line
  754.  
  755.                                      COSWORTH AUTO=LONGDIST
  756.  
  757.     DIR <=FileName>  - Cause Cosworth to start up using an alternative
  758.                        dialling directory to the default COSWORTH.PHN. The
  759.                        '.PHN' extension is optional.
  760.  
  761.                        For example, to start up COSWORTH to use the
  762.                        LOCAL.PHN Dialling Directory you would use the
  763.                        command line
  764.  
  765.                                      COSWORTH DIR=LOCAL
  766.  
  767.     NOCHECKING       - Disables checking for presence of modem on port
  768.                        prior to its use. When entering Auto Dialler,
  769.                        Terminal Mode or when commencing dialling from a
  770.                        directory, COSWORTH checks to see if there is a
  771.                        working modem on the port in question. If it cannot
  772.                        detect one then an error is issued. The method
  773.                        COSWORTH uses to detect the modem may not be
  774.                        compatible with older modems and is noticed not to
  775.                        be completely reliable when running COSWORTH under
  776.                        Microsoft Windows. If you experience difficulties
  777.                        in this, try starting up COSWORTH with
  778.  
  779.                                       COSWORTH NOCHECKING
  780.  
  781.     Although these switches can be used in combination without a problem,
  782.     it makes no sense to start up COSWORTH with both the AUTO and DIR
  783.     switches as COSWORTH will immediately exit back to the operating
  784.     system on completion of the command line Auto Dialler sequence.
  785.  
  786.  
  787.  
  788.  
  789.  
  790.     COSWORTH COMMUNICATIONS SOFTWARE - Command Line Switches        page 12
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.     EXIT CODES
  800.     ----------
  801.  
  802.     When exiting, COSWORTH will leave a DOS ERRORLEVEL of 1 if a fatal
  803.     error caused COSWORTH to terminate, otherwise a nominal ERRORLEVEL of
  804.     zero is left.
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.     COSWORTH COMMUNICATIONS SOFTWARE - Command Line Switches        page 13
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.     CONFIGURING COSWORTH
  866.     --------------------
  867.  
  868.     COSWORTH has been designed to allow the user to configure it in the
  869.     way that best suits his or her needs. Configuration is completely
  870.     automated and is controlled though the Configuration entry in the main
  871.     menu.
  872.  
  873.  
  874.     THE COSWORTH CONFIGURATION FILE
  875.     -------------------------------
  876.  
  877.     The way in which you use and have set up COSWORTH is saved into a
  878.     configuration file called COSWORTH.CFG which MUST reside in the main
  879.     program directory.
  880.  
  881.     Obviously, this file is very important. If it gets lost or corrupted
  882.     then COSWORTH will have no way of knowing how you want it to work. To
  883.     this end, certain protection measures have been built into COSWORTH to
  884.     ensure that a configuration file is always at hand.
  885.  
  886.     When COSWORTH starts up, the first thing it does is read in the
  887.     configuration file. If it cannot find COSWORTH.CFG on the main program
  888.     path,or if it is the wrong size (implying that it has become
  889.     corrupted) then it generates an error message and creates a
  890.     configuration file out of defaults. NOTE - these are NOT the defaults
  891.     you specify in the configuration (obviously!) since they have been
  892.     lost. COSWORTH will then inform you of what it has done and will then
  893.     launch you straight into the configuration menu to change the settings
  894.     to those which you prefer. Quitting from the configuration menu will
  895.     automatically save the COSWORTH.CFG file (only under these
  896.     circumstances) and will put you back into COSWORTH as normal.
  897.  
  898.     If COSWORTH finds that the configuration file is the right size, but
  899.     that it cannot find COSWORTH.EXE on the path defined as the 'program
  900.     path' (see below) then it generates another error message and again
  901.     launches you into the configuration menu. This time, since the file is
  902.     the right length, it uses the settings it has found, thereby saving
  903.     you from re-entering them all again. (The failure to detect
  904.     COSWORTH.EXE may be attributed to third party DOS software which
  905.     allows you to rename directories. If you rename the main COSWORTH
  906.     program directory then you'll get this kind of error.)
  907.  
  908.     However, this kind of error is rare. You'll probably find that
  909.     COSWORTH reads the configuration file every time, but these safeguards
  910.     are there 'just in case'! Now who says that programmers don't care?
  911.     (Okay, okay, hands down...)
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 14
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.     HOW TO CONFIGURE COSWORTH
  932.     -------------------------
  933.  
  934.     COSWORTH has been designed to allow the user to configure it in the
  935.     way that best suits his or her needs. Configuration is completely
  936.     automated and is controlled though the Configuration entry in the main
  937.     menu.
  938.  
  939.     Selecting this brings up a further sub menu which looks like this;
  940.  
  941.                      ┌───────────────────────────────────┐
  942.                      │        CONFIGURATION MENU         │
  943.                      │   Select Choice or ESC to Quit    │
  944.                      │                                   │
  945.                      │     >F1  Port                     │
  946.                      │      F2  Modem Strings            │
  947.                      │      F3  Colours                  │
  948.                      │      F4  Protocols                │
  949.                      │      F5  Paths                    │
  950.                      │      F6  Program Settings         │
  951.                      │      F7  Directory Defaults       │
  952.                      │      F8  Save Configuration       │
  953.                      │      F9  EXIT                     │
  954.                      │                                   │
  955.                      └───────────────────────────────────┘
  956.  
  957.     Each choice can be selected by either pressing the associated
  958.     function key or by moving the scroll bar up and down using either the
  959.     arrow keys, mouse or space bar and then pressing enter over the
  960.     required choice. We'll examine each of these choices in turn.
  961.  
  962.  
  963.     PORT
  964.     ----
  965.  
  966.     This brings up yet another scrolling menu which offers you the choice
  967.     of which port to use.
  968.  
  969.                              ┌──────────────────┐
  970.                              │ Set Serial Port  │
  971.                              │                  │
  972.                              │      >COM1       │
  973.                              │       COM2       │
  974.                              │       COM3       │
  975.                              │       COM4       │
  976.                              │                  │
  977.                              └──────────────────┘
  978.  
  979.     Note that there is no need to run any program prior to COSWORTH to
  980.     locate the addresses of ports COM3 and COM4 in your machines memory -
  981.     COSWORTH does this for you.
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 15
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.     MODEM STRINGS
  998.     -------------
  999.  
  1000.     This brings up a larger screen which invites you to enter the strings
  1001.     which control the use of your modem. Some modem control strings will
  1002.     require the use of a terminating return character or other control
  1003.     characters. This is difficult to enter in a data entry format like
  1004.     that which COSWORTH uses, so a '#' character is used in place of a
  1005.     return character. Once you save the modem strings then the character
  1006.     is interpreted and, if you re-examine the strings, you will see that
  1007.     the '#' characters are replaced by the 'musical note' character, being
  1008.     ASCII 13 - the return character.
  1009.  
  1010.     To insert control characters into your modem strings use the caret
  1011.     notation. For example, ^M is interpreted as CTRL-M, which would insert
  1012.     a return character. To insert a caret into your strings use two carets
  1013.     together, as in ^^. Some of the more familiar control characters are
  1014.  
  1015.                      ^M        CR        Carriage Return
  1016.                      ^J        LF        Line Feed
  1017.                      ^L        FF        Form Feed
  1018.                      ^[        ESC       Escape
  1019.  
  1020.     The illustration below gives some examples.
  1021.  
  1022.  
  1023.    ┌───────────────────┤ ENTER MODEM CONTROL STRINGS ├────────────────────┐
  1024.    │ RESET             ATZ^M............................................. │
  1025.    │ INITIALISATION    AT S7=60 S0=0 V1 X3^M............................. │
  1026.    │ HANG UP           ~~~+++~~~AT H0^M.................................. │
  1027.    │ MODEM OK          OK.............    MODEM ERROR     ERROR.......... │
  1028.    │ PREFIX 1          ATDT.............................................. │
  1029.    │ PREFIX 2          AT&M0DT........................................... │
  1030.    │ PREFIX 3          ATB0DT............................................ │
  1031.    │ PREFIX 4          AT&N3DT........................................... │
  1032.    │ PREFIX 5          .................................................. │
  1033.    │ BUSY STRINGS      NO CARRIER, BUSY, RINGING......................... │
  1034.    │ PORT LOCKED?      N                                                  │
  1035.    │                                                                      │
  1036.    │ CONNECT 300       CONNECT^M......    CONNECT 1200    CONNECT 1200... │
  1037.    │ CONNECT 2400      CONNECT 2400...    CONNECT 4800    CONNECT 4800... │
  1038.    │ CONNECT 7200      CONNECT 7200...    CONNECT 9600    CONNECT 9600... │
  1039.    │ CONNECT 12000     CONNECT 12000..    CONNECT 14400   CONNECT 14400.. │
  1040.    │ CONNECT 19200     CONNECT 19200..    CONNECT 38400   CONNECT 38400.. │
  1041.    │ CONNECT 57600     CONNECT 57600..                                    │
  1042.    │                                                                      │
  1043.    │ MERCURY PREFIX    131,1234567890.................................... │
  1044.    └─────────────────┤ F1 HELP, F10 ACCEPTS, ESC ABORTS ├─────────────────┘
  1045.  
  1046.     For the exact strings required by your particular modem, consult your
  1047.     modem manual. The installation program will fill this table out with
  1048.     default values, but they may not be suitable for your modem. Please
  1049.     check them prior to attempting to dial out using COSWORTH!
  1050.  
  1051.  
  1052.  
  1053.  
  1054.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 16
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.     If you need further help then pressing F1 will bring up a help screen
  1064.     summarising the meanings of the individual strings. The modem control
  1065.     strings above are specified as;
  1066.  
  1067.     RESET - This string is sent to your modem when first starting to dial
  1068.             or when starting up in terminal mode, resetting your modem
  1069.             back to it's default settings. Notice that this string (in the
  1070.             above case) is terminated with the interpreted '#' for a
  1071.             return character.
  1072.  
  1073.     INITIALISATION - This is sent to your modem AFTER the RESET string has
  1074.                      been received. It is generally used for initialising
  1075.                      various 'S' registers in your modem, the verbal or
  1076.                      numeric result codes and the result code options,
  1077.                      although it can contain any other modem controls you
  1078.                      wish. Notice that this string (in the above case) is
  1079.                      terminated with the interpreted '^M' for a return
  1080.                      character.
  1081.  
  1082.     HANG UP - This is the string that COSWORTH will fire at your modem to
  1083.               make it hang up and drop the carrier. However, before doing
  1084.               so, COSWORTH will always attempt to hang up by a faster
  1085.               method; it will attempt to lower (that is, turn off) the DTR
  1086.               bit on the selected serial port. This usually drops the
  1087.               lines with most modems. If this fails, however, the HANG UP
  1088.               string will be sent (up to ten times, if necessary!) to drop
  1089.               the line. If this also fails then an error is produced.
  1090.  
  1091.     MODEM OK - This is the string that will be returned by your modem on
  1092.                successful completion of the last command sent. On most
  1093.                Hayes-compatible modems this string will simply be 'OK' but
  1094.                it is best to check with your manufacturer's manual first.
  1095.                Note that you *must* enter something in this field - you
  1096.                cannot just leave it blank. This is to ensure that all
  1097.                commands sent to your modem from the dialling directory are
  1098.                being processed properly.
  1099.  
  1100.     MODEM ERROR - This is the string that will be returned by your modem
  1101.                   on UNSUCCESSFUL completion of the last command sent. On
  1102.                   most Hayes-compatible modems this string will simply be
  1103.                   'ERROR' but it is best to check with your manufacturer's
  1104.                   manual first. Note that you *must* enter something in
  1105.                   this field - you cannot just leave it blank. This is to
  1106.                   ensure that all commands sent to your modem from the
  1107.                   dialling directory are being processed properly.
  1108.  
  1109.     PREFIX 1..5 - These are the dialling prefixes which are sent prior to
  1110.                   the telephone number selected in the dialling directory.
  1111.                   For instance, in the above example, PREFIX 1 is set to
  1112.                   'ATDT' which will enable tone dialling. Five prefixes
  1113.                   are permitted in all, allowing you different
  1114.                   configurations for connecting to systems with a wide
  1115.                   variety of specifications, without having to reconfigure
  1116.                   COSWORTH each time.
  1117.  
  1118.  
  1119.  
  1120.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 17
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.     BUSY STRINGS - These are the strings returned by your modem should a
  1130.                    connection fail to be made at all. They ought to be
  1131.                    entered in the above table separated by commas.
  1132.  
  1133.     PORT LOCKED? - If you specify 'Y' to PORT LOCKED? then your modem will
  1134.                    not renegotiate the baud rate returned by the incoming
  1135.                    connect string. If you specify 'N' then your modem will
  1136.                    be reinitialised to the actual connect speed. You ought
  1137.                    to select 'Y' to this option if your modem is either
  1138.                    working at high speed (ie, over or equal to 9600 baud),
  1139.                    is error correcting or supports MNP error correction.
  1140.                    Otherwise, select 'N'.
  1141.  
  1142.     CONNECT 300    - These are the strings that your modem returns on
  1143.     CONNECT 1200   making a successful connection. They may vary from
  1144.     CONNECT 2400   modem to modem, but generally ought to be similar to
  1145.     CONNECT 4800   those entered by the installation program. Notice that
  1146.     CONNECT 7200   the 'standard' connect string for 300 baud is just
  1147.     CONNECT 9600   'CONNECT'. Since every connect string is likely to
  1148.     CONNECT 12000  contain this word, care should be taken to ensure that
  1149.     CONNECT 14400  the 300 baud string is terminated with a return
  1150.     CONNECT 19200  character (either # or ^M) in order to prevent all
  1151.     CONNECT 38400  connections from being recognised as being at 300 baud.
  1152.     CONNECT 57600
  1153.  
  1154.     MERCURY PREFIX - If you are a subscriber to Mercury Communications
  1155.                      then you can force a Mercury connection by preceding
  1156.                      the telephone number entry in the dialling directory
  1157.                      with an 'M'. In order to connect with Mercury, you'll
  1158.                      have to let COSWORTH know what your authorisation
  1159.                      number is. Enter it in this box. You'll also have to
  1160.                      enter the preceding code (which is 131 at the time of
  1161.                      writing) and maybe a separating comma (,) to pause
  1162.                      the modem prior to sending out your personal code.
  1163.  
  1164.     To edit an entry, move the highlight bar down to it and type in what
  1165.     you wish. If the first character you press is a letter or number key,
  1166.     then the entry will be erased and you can re-enter the whole string.
  1167.     If you don't wish to retain the entry then press the up or down arrow
  1168.     keys and the original string will reappear, otherwise, press [RETURN]
  1169.     to 'keep' your modifications to each string.
  1170.  
  1171.     Once you are satisfied with your entries, press F10 to keep them.
  1172.     Pressing ESCape aborts the editing procedure, although you will be
  1173.     asked to confirm that you want to abort.
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 18
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.     COLOURS
  1196.     -------
  1197.  
  1198.     You are free to change the colours in COSWORTH to suit your tastes.,
  1199.     After all, you might not like our choice! The colour configuration
  1200.     menu looks like this;
  1201.  
  1202.   ┌─This is a menu──────────────────────┐          SELECT ITEM TO ALTER
  1203.   │      This is the header colour      │ ┌────────────────────────────────────┐
  1204.   │  F1   This is an unselected choice  │ │   A - Main Menu Foreground         │
  1205.   │  F2   This is a selected choice     │ │   B - Main Menu Background         │
  1206.   │  F3   This is an unselected choice  │ │   C - Main Menu Border             │
  1207.   │  F4   This is an unselected choice  │ │   D - Main Menu Emphasised         │
  1208.   │       This is emphasised text       │ │   E - Hot Key Menu Initial         │
  1209.   │            Hot Keys Menu            │ │   F - Hot Key Menu Text            │
  1210.   │  Field Prompt Field Input.........  │ │   G - Field Prompt Text            │
  1211.   └─────────────────────────────────────┘ │   H - Field Input Foreground       │
  1212.   ┌─This is a help screen───────────────┐ │   I - Field Input Background       │
  1213.   │    This is the help screen text     │ │   J - Main Menu Header Message     │
  1214.   │    This is a help screen message    │ │   K - Bar/Error Message Foreground │
  1215.   │  This is a help screen instruction  │ │   L - Bar/Error Message Background │
  1216.   └─────────────────────────────────────┘ │   M - Advisory Message Foreground  │
  1217.   ┌─This is a directory─────────────────┐ │   N - Advisory Message Background  │
  1218.   │  SCRIPTS      <DIR> 20:8:91 12:48p  │ │   O - Help Screen Foreground       │
  1219.   │  COSWORTH.EXE 73546 20:9:91  5:23a  │ │   P - Help Screen Background       │
  1220.   │  COSWORTH.CFG  1358 23:9:91  9:14p  │ │   Q - Directory Border Foreground  │
  1221.   │  COSWORTH.SNP 13776 24:9:91  2:34a  │ │   R - Directory Border Background  │
  1222.   └─────────────────────────────────────┘ │   S - Style of Menu Borders        │
  1223.         This is an advisory message       └────────────────────────────────────┘
  1224.          This is an error message
  1225.  
  1226.        ESC Abort : F1 Help : F2 Restore : F3 Colour : F4 Mono : F10 Save
  1227.  
  1228.     The menu on the RIGHT controls which attributes to change. Selecting
  1229.     any but the last entry brings up a (coloured) list of colours for you
  1230.     to choose from. Select the colour you wish and the dummy menus on the
  1231.     LEFT will be updated to reflect that choice. The last 'Style of Menu
  1232.     Borders' menu selection will call up four different box styles for you
  1233.     to choose from.
  1234.  
  1235.     Pressing F2 will restore the altered colours to those which you
  1236.     started off with (just in case you get carried away!), F3 will reset
  1237.     the colours to the COLOUR default and F4 will reset them to the
  1238.     MONOCHROME defaults. F10 saves the colour set up and ESC aborts, with
  1239.     confirmation.
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.     PROTOCOLS
  1262.     ---------
  1263.  
  1264.     Selecting this option brings up the main protocol menu. Move the
  1265.     scroll bar up and down the menu using the arrow keys, space bar or
  1266.     mouse and either select the required protocol to edit using the return
  1267.     key, delete a protocol from the menu by pressing DEL or abort the
  1268.     process by pressing ESC. Selecting the blank entry at the end of the
  1269.     menu will append a new protocol definition to the end of the menu. You
  1270.     can have up to 20 protocol definitions at any one time - more than
  1271.     enough for most people!
  1272.  
  1273.                              ┌─────Select Menu ─────┐
  1274.                              │>X - Xmodem          <│
  1275.                              │ C - Xmodem - CRC     │
  1276.                              │ Y - Ymodem           │
  1277.                              │ Z - Zmodem           │
  1278.                              │   -                  │
  1279.                              └──────────────────────┘
  1280.  
  1281.     In the above example, lets assume you have selected Xmodem and wish to
  1282.     edit the settings for that external protocol. You will then be
  1283.     presented with the protocol configuration menu which looks like this;
  1284.  
  1285. ┌──────────────────────────────────────────────────────────────────────────────┐
  1286. │Hotkey          : X                                                           │
  1287. │Protocol Name   : Xmodem.........                                             │
  1288. │Upload Command  : xmod.com port *comport speed *baud sx *fname................│
  1289. │Download Command: xmod.com port *comport speed *baud rx *fname................│
  1290. └──────────────────────────────────────────────────────────────────────────────┘
  1291.  
  1292.     You can move about the fields using the arrow keys, mouse or return
  1293.     key. The meanings of each field are as follows;
  1294.  
  1295.     HotKey - This is the character which will appear on the left of the
  1296.              protocol menu when it is called up. (as in the example above)
  1297.              You can quickly select to use this protocol by simply
  1298.              pressing the hot key rather than moving the scroll bar about.
  1299.  
  1300.     Protocol Name - This is the name of the protocol (not necessarily the
  1301.                     name of the protocol file - it can be anything you
  1302.                     like) as it will appear in the dialling directory
  1303.                     information box.
  1304.  
  1305.     Upload/Download Command - These are the full DOS commands to start
  1306.                               uploading or downloading files using this
  1307.                               particular protocol. The command MUST start
  1308.                               with the file's name (just as if starting it
  1309.                               from DOS) and can then take any arguments it
  1310.                               requires.
  1311.  
  1312.     The protocol menu will NOT allow you to save upload and download
  1313.     commands lines unless the actual protocol program exists within the
  1314.     protocol menu!
  1315.  
  1316.  
  1317.  
  1318.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 20
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.     In order to assist you in setting up the protocols menu, and to
  1328.     accommodate any configurational changes to COSWORTH, there are four
  1329.     COSWORTH system variables which you can include in the command line;
  1330.  
  1331.          *COMPORT - This returns the current serial port being used. For
  1332.                     example, if you are set up to use COM1 then *COMPORT
  1333.                     will return "1"
  1334.  
  1335.          *BAUD    - This returns the current baud rate that the connection
  1336.                     is at. If connected at 2400 baud then *BAUD will
  1337.                     return "2400".
  1338.  
  1339.          *FNAME   - This is the name of the file(s) you are uploading or
  1340.                     downloading.
  1341.  
  1342.          *PATH    - This is the path from which either files are being
  1343.                     uploaded from or downloaded into, depending upon
  1344.                     which (uploading or downloading) you are currently
  1345.                     doing.
  1346.  
  1347.        *LINESPEED - This will return the actual speed of the connection,
  1348.                     irrespective of the baud rate that the port is set at.
  1349.                     This may be useful in circumstances where a protocol
  1350.                     will return an accurate estimate of the transfer time
  1351.                     but where the port is set to a higher rate than the
  1352.                     connection speed.
  1353.  
  1354.     For further advice in setting up your protocols, refer to your
  1355.     protocol's documentation.
  1356.  
  1357.     One of the most popular file transfer protocol programs is Omen
  1358.     Technology's DSZ. As an example, here are the settings we recommend
  1359.     you use for Zmodem, Ymodem and Ymodem-g. (NB - your copy of DSZ may be
  1360.     called dsz.exe!)
  1361.  
  1362. ┌──────────────────────────────────────────────────────────────────────────────┐
  1363. │Hotkey          : Z                                                           │
  1364. │Protocol Name   : Zmodem.........                                             │
  1365. │Upload Command  : dsz.com port *comport speed *baud p sz *fname...............│
  1366. │Download Command: dsz.com port *comport speed *baud p rz -mr *path............│
  1367. └──────────────────────────────────────────────────────────────────────────────┘
  1368. ┌──────────────────────────────────────────────────────────────────────────────┐
  1369. │Hotkey          : Y                                                           │
  1370. │Protocol Name   : Ymodem.........                                             │
  1371. │Upload Command  : dsz.com port *comport speed *baud sb *fname.................│
  1372. │Download Command: dsz.com port *comport speed *baud rb *path..................│
  1373. └──────────────────────────────────────────────────────────────────────────────┘
  1374. ┌──────────────────────────────────────────────────────────────────────────────┐
  1375. │Hotkey          : G                                                           │
  1376. │Protocol Name   : Ymodem-g.......                                             │
  1377. │Upload Command  : dsz.com port *comport speed *baud sb -k *fname..............│
  1378. │Download Command: dsz.com port *comport speed *baud rb -g *path...............│
  1379. └──────────────────────────────────────────────────────────────────────────────┘
  1380.  
  1381.  
  1382.  
  1383.  
  1384.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 21
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.     PATHS
  1394.     -----
  1395.  
  1396.     Select this option to set up the file paths to the various files which
  1397.     are required by COSWORTH. A menu will appear in th centre of the
  1398.     screen showing your current file path settings.
  1399.  
  1400.      ┌─────────────────────┤ ENTER DIRECTORY PATHS ├─────────────────────┐
  1401.      │ PROGRAM PATH   C:\COSWORTH\...................................... │
  1402.      │ UPLOAD PATH    C:\COSWORTH\UPLOAD................................ │
  1403.      │ DOWNLOAD PATH  C:\COSWORTH\DOWNLOAD.............................. │
  1404.      │ PROTOCOL PATH  C:\COSWORTH\PROTOCOL\............................. │
  1405.      │ SCRIPT PATH    C:\COSWORTH\SCRIPTS\.............................. │
  1406.      └───────────────────┤ F10 TO ACCEPT, ESC ABORTS ├───────────────────┘
  1407.  
  1408.     Move between the fields using the arrow keys, return character or tab
  1409.     key. The paths ought to be as follows;
  1410.  
  1411.         PROGRAM PATH   - This is where COSWORTH.EXE resides, along with
  1412.                          all its support files.
  1413.         UPLOAD PATH    - This is where files will uploaded from, by
  1414.                          default.
  1415.         DOWNLOAD PATH  - This is where files will downloaded into, by
  1416.                          default.
  1417.         PROTOCOL PATH  - This is where your external protocol programs
  1418.                          reside, along with any support files that they
  1419.                          require.
  1420.         SCRIPT PATH -    This is (guess what?) where your script files
  1421.                          are.
  1422.  
  1423.     If you leave the program path blank then it is assumed that
  1424.     COSWORTH.EXE is in the current directory. Leaving any other field
  1425.     blank assumes that the file path lives directly 'off' the program
  1426.     path, in its 'default' name. The upload directory defaults to
  1427.     'UPLOAD', the download directory defaults to 'DOWNLOAD', the protocols
  1428.     directory defaults to 'PROTOCOL' and the script file directory
  1429.     defaults to 'SCRIPTS'.
  1430.  
  1431.     Once you have entered the names to your satisfaction, press F10 to
  1432.     keep them, otherwise press ESC to abort the process. (with
  1433.     confirmation)
  1434.  
  1435.     If any of the directories that you specify does not exist then
  1436.     COSWORTH will create them accordingly, however, in the case of the
  1437.     protocol directory, ensure that the protocol programs themselves are
  1438.     physically in the directory before attempting to make any connection.
  1439.  
  1440.     If, when you press F10 to keep the settings, you have specified a
  1441.     non-existent program path (that is, if COSWORTH cannot find its own
  1442.     EXE file in it!) then you will receive an error message and will be
  1443.     prompted to re-enter the program path name again.
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 22
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.     PROGRAM SETTINGS
  1460.     ----------------
  1461.  
  1462.     This menu sets up some of the 'miscellaneous' settings used by other
  1463.     aspects of the program, most notably your script files. Calling this
  1464.     option brings up the following menu;
  1465.  
  1466.                      ┌───────────────────────────────────┐
  1467.                      │         PROGRAM SETTINGS          │
  1468.                      │   Select Choice or ESC to Quit    │
  1469.                      │                                   │
  1470.                      │    >F1 Sound is ON                │
  1471.                      │     F2 Log file is ON             │
  1472.                      │     F3 Users Name                 │
  1473.                      │     F4 Auto Dialler Time Out      │
  1474.                      │     F5 Define Mail Files          │
  1475.                      │     F6 Default Script Timeout     │
  1476.                      │     F7 Exit                       │
  1477.                      │                                   │
  1478.                      └───────────────────────────────────┘
  1479.  
  1480.     Move the highlighted scroll bar with the arrow keys, mouse or space
  1481.     bar and select the option you wish by pressing return, pressing the
  1482.     associated function key or by clicking the mouse once. Each option has
  1483.     a slightly different usage.
  1484.  
  1485.     Sound Toggle - Selecting this option 'toggles' the usage of sound (on
  1486.                    connection to remote systems or on errors). For
  1487.                    example, in the above illustration, if you were to
  1488.                    press F1 then the menu entry would change to 'Sound is
  1489.                    OFF'. Pressing it once again would change it back to
  1490.                    'Sound is ON', and so on.
  1491.  
  1492.     Log File Toggle - Selecting this option 'toggles' the usage of a
  1493.                       detailed running log file of all connections made.
  1494.                       (COSWORTH.LOG, found in the main program directory)
  1495.                       For example, in the above illustration, if you were
  1496.                       to press F2 then the menu entry would change to 'Log
  1497.                       file is OFF'. Pressing it once again would change it
  1498.                       back to 'Log file is ON', and so on.
  1499.  
  1500.     Users Name - This one will simply ask you for your name! This is
  1501.                  needed in order to allow script files to use the script
  1502.                  variables *NAME, *FIRST and *LAST properly.
  1503.  
  1504.     Auto Dialler Time Out - You will be prompted to enter the time (in
  1505.                             minutes) that the Auto Dialler will time out
  1506.                             after if no data is received from the remote
  1507.                             system, usually a sign that your script file
  1508.                             has gone awry or that the remote system has
  1509.                             hung. The value entered must be between 1 and
  1510.                             99, though anyone selecting anything like 99
  1511.                             minutes for an Auto Dialler time out needs to
  1512.                             have a good talking to!
  1513.  
  1514.  
  1515.  
  1516.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 23
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.     Define Mail Files - One of the problems facing users of all kinds of
  1526.                         PC Communications is the use of electronic mail.
  1527.                         Mail can be read offline (thereby saving your
  1528.                         phone bills) by downloading 'mailbags', replying
  1529.                         to them using an offline mail editor, then
  1530.                         uploading your replies to the remote system the
  1531.                         next time you log on. The theory is that you then
  1532.                         delete your replies and then edit the replies to
  1533.                         the mailbag you have just downloaded. Great, eh?
  1534.  
  1535.                         Unfortunately, there is a problem; what if you
  1536.                         forget to delete the uploaded replies from your
  1537.                         upload directory. You will probably at some time
  1538.                         forget what you have done and upload the same
  1539.                         replies twice. Not all host systems have
  1540.                         intelligent enough mail routines to detect whether
  1541.                         you've already uploaded replies and will gaily
  1542.                         sort them as if they were brand new, thereby
  1543.                         duplicating all your messages, making you look a
  1544.                         complete fool and incurring the wrath of the
  1545.                         System Operator whose hard disk has to hold all
  1546.                         this duplicated stuff. Okay, so what if it's only
  1547.                         one or two messages? But what if it were a dozen?
  1548.                         Or six hundred? More problems...but COSWORTH comes
  1549.                         to the rescue!
  1550.  
  1551.                         If you select this option you will be presented
  1552.                         with the following line;
  1553.  
  1554.           Enter file masks : *.REP FORTH*.*......................
  1555.  
  1556.                         You can then enter up to TEN file 'masks' (that
  1557.                         is, filenames using the DOS wildcards '*' and '?',
  1558.                         if you wish) which specify the file names of all
  1559.                         your mailbag replies. The installation program
  1560.                         puts in the above entries, where for example
  1561.                         '*.REP' is the name of the reply mailbag generated
  1562.                         by QWK compatible offline mailers. If you upload a
  1563.                         file which falls into any of the (maximum of) ten
  1564.                         file masks you specify, then you will receive a
  1565.                         prompt asking you if you wish to delete the
  1566.                         mailbag. Simply tell COSWORTH that you wish the
  1567.                         file to be deleted, and wave bye bye to
  1568.                         duplicated, mail uploads forever more!
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 24
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.                         Well...almost forever more. You will only receive
  1592.                         the file deletion request IF YOU RECEIVE BACK A
  1593.                         ZERO DOS 'ERRORLEVEL' FROM THE PROTOCOL PROGRAM
  1594.                         DOING THE UPLOAD! If the protocol program returns
  1595.                         anything other that a zero ERRORLEVEL then it
  1596.                         generally means something went wrong somewhere
  1597.                         along the line and the upload never took place.
  1598.                         Fair enough? Almost. However, some protocol
  1599.                         programs return non-zero ERRORLEVELs even when
  1600.                         everything went fine! So you will *probably* not
  1601.                         ever have duplicated mailbags again!
  1602.  
  1603.     Default Script Timeout - This will prompt you for the time (in
  1604.                              seconds) that COSWORTH will wait after
  1605.                              waiting for a script file prompt specified by
  1606.                              a script RECEIVE command. That is, if
  1607.                              COSWORTH is has got to this point in a script
  1608.                              file...
  1609.  
  1610.                                      RECEIVE "This is a prompt!"
  1611.  
  1612.                              ...then it will allow a certain length of
  1613.                              time to receive this prompt before timing the
  1614.                              script file out (and aborting it and, if you
  1615.                              are using it, dropping the carrier in Auto
  1616.                              Dialler Mode). That length of time is the
  1617.                              default script timeout. You can enter
  1618.                              anything you like between 1 (which is
  1619.                              probably just a tad too fast!) and 9999
  1620.                              seconds.
  1621.  
  1622.     Selecting EXIT from the main menus presents you with confirmation as
  1623.     to whether you wish to keep any of the changes you have made. You will
  1624.     then be taken back to the main configuration menu.
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 25
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.     DIRECTORY DEFAULTS
  1658.     ------------------
  1659.  
  1660.     This menu will ask you for the default settings for your dialling
  1661.     directory entries. When you add a new dialling directory entry, it
  1662.     will be pre-filled out with the settings read from the directory
  1663.     defaults, thereby saving you having to type them all in, although you
  1664.     can obviously change them if you wish to.
  1665.  
  1666.     These are also the default values used to initialise the port when in
  1667.     COSWORTH's Terminal Mode, although they can be overridden by issuing
  1668.     other commands from the terminal itself.
  1669.  
  1670.     The default entry table looks like this;
  1671.  
  1672.  
  1673.              ┌───────┤ ENTER DEFAULT DIRECTORY SETTINGS ├────────┐
  1674.              │                                                   │
  1675.              │         BAUD             19200                    │
  1676.              │         PARITY           None                     │
  1677.              │         DATA BITS        8                        │
  1678.              │         STOP BITS        1                        │
  1679.              │         HANDSHAKING      RTS/CTS                  │
  1680.              │         PREFIX           1                        │
  1681.              │         TERMINAL         ANSI                     │
  1682.              │         PROTOCOL         Zmodem                   │
  1683.              │         DIAL TIME        99                       │
  1684.              │         LOCAL ECHO       NO                       │
  1685.              │         LINE FEEDS       NO                       │
  1686.              │         DEST BS          YES                      │
  1687.              │                                                   │
  1688.              └──────────────────┤ ESC TO QUIT ├──────────────────┘
  1689.  
  1690.   Enter baud : 300 1200 2400 4800 7200 9600 12000 14400 19200 38400 57600
  1691.  
  1692.  
  1693.     The current position is highlighted and the valid choices are at the
  1694.     foot of the screen. To change each setting, use the left and right
  1695.     arrow keys to move the highlight block on the lower (strip) menu and
  1696.     press return on the entry you wish to select. If you want to move to
  1697.     another entry in the upper (vertical) menu then use the up and down
  1698.     arrow keys until you reach the point you are after. Most selections
  1699.     are presented as either multiple choice (as in the BAUD example above)
  1700.     or as Yes/No choices (for example, in the LOCAL ECHO) entry.
  1701.  
  1702.     If you wish to alter the default protocol to be used then select YES
  1703.     from the 'Change Protocol? (Y/N)' prompt and you will be presented
  1704.     with the protocol menu, allowing you to select the default protocol
  1705.     from all those installed into COSWORTH.
  1706.  
  1707.     For explicit descriptions of the meanings of all these fields, please
  1708.     consult the documentation regarding the dialling directory itself.
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 26
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.     SAVE CONFIGURATION
  1724.     ------------------
  1725.  
  1726.     Once you have made all the amendments you wish to COSWORTH's
  1727.     configuration then you are free to carry on and use them. However,
  1728.     unless you explicitly SAVE the configuration then the changes you have
  1729.     made will be lost when you quit the program. To make the changes
  1730.     permanent, select Save Configuration from the menu and the
  1731.     configuration file COSWORTH.CFG will be rewritten to reflect your
  1732.     changes. This way, all your changes will be preserved the next time
  1733.     you start up COSWORTH.
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.     COSWORTH COMMUNICATIONS SOFTWARE - Configuring Cosworth         page 27
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.     THE DIALLING DIRECTORY
  1790.     ----------------------
  1791.  
  1792.     The COSWORTH dialling directory has been designed to be both easy to
  1793.     use and informative.
  1794.  
  1795.     Dialling directories are saved using the file extension PHN. By
  1796.     default, when starting up COSWORTH the dialling directory COSWORTH.PHN
  1797.     is loaded, although this can be over-ridden by using the DIR= command
  1798.     line directive to load another directory.
  1799.  
  1800.     Once you have installed COSWORTH onto your system a sample dialling
  1801.     directory is created which contains the dialling details for four
  1802.     popular bulletin board systems. This is how the dialling directory
  1803.     may look, depending upon the choices you made in the installation
  1804.     program;
  1805.  
  1806. ┌──────────────────────┤ Dialling Directory COSWORTH ├─────────────────────────┐
  1807. │     Name of Remote System          Telephone Number     Baud   Port  Script  │
  1808. ├────┬──────────────────────────────┬────────────────────┬──────┬─────┬────────┤
  1809. │   1│ALMAC BBS                     │0324 665371         │2400  │8-N-1│ALMAC   │
  1810. │   2│FORTH VIEW BBS                │031 660 6680        │2400  │8-N-1│PC-BOARD│
  1811. │   3│BLUE LABEL BBS                │0224 827166         │2400  │8-N-1│BLUELBL │
  1812. │   4│PISTON POPPER BBS             │0424 853361         │2400  │8-N-1│PISTON  │
  1813. │   5│MISSION IMPOSSIBLE            │0602 654329         │2400  │8-N-1│MISSPOSS│
  1814. │    │                              │                    │      │     │        │
  1815. │    │                              │                    │      │     │        │
  1816. │    │                              │                    │      │     │        │
  1817. │    │                              │                    │      │     │        │
  1818. ├────┴──────────────────────────────┴────────────────────┴──────┴─────┴────────┤
  1819. │ System Name  ALMAC BBS                          Number Of Calls 0            │
  1820. │ Password                      Prefix # 1        Dialling Time 60 seconds     │
  1821. │ Handshaking XON/XOFF          Terminal ANSI     Protocol XCos (Xmodem)       │
  1822. │ Total Time Spent On Line  0 minute(s) and 0 seconds                          │
  1823. ├──────────────────────────────────────────────────────────────────────────────┤
  1824. │ Dial Insrt Create Edit Copy Manual Remove Sort Print New Load Zero Tag Untag │
  1825. └──────────────────────────────────────────────────────────────────────────────┘
  1826.  
  1827.     The upper section of the directory display consists of a window with a
  1828.     highlighted entry, indicating the current selection. If there are more
  1829.     than ten entries in each directory then these can be shown by moving
  1830.     the highlight bar. The highlight bar can be moved using the PageUp,
  1831.     PageDn, Home, End and arrow keys as well as by using a mouse. The
  1832.     lower panel shows more detailed information about the settings for the
  1833.     currently selected entry. (In the case of the sample directory, this
  1834.     information is based upon your responses to the questions posed in the
  1835.     INSTALL.EXE program)
  1836.  
  1837.     Several connections can be made in succession by selecting the current
  1838.     entry by using the space bar. Once selected in this manner a marker
  1839.     will appear on the right hand side of the dialling entry indicating
  1840.     that that entry has been selected. To deselect an entry, move the
  1841.     highlight bar back to it and press the space bar again. You can select
  1842.     any number of entries in this manner, causing a queue of entries to be
  1843.     connected at any one time.
  1844.  
  1845.  
  1846.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 28
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.     The upper window shows the name and telephone number of each entry in
  1856.     the directory followed by the baud rate, summarised port settings and
  1857.     the name of any script file associated with that particular entry.
  1858.  
  1859.     The lower panel shows the number of calls made, the password (if
  1860.     specified) for the current entry, the required dialling prefix, the
  1861.     dialling time for each attempt to connect to the current entry, the
  1862.     handshaking protocol, the kind of display that is used, the default
  1863.     file transfer protocol plus the total length of all successful
  1864.     connections made.
  1865.  
  1866.     Along the bottom of the directory display is a list of the possible
  1867.     commands that you can issue by pressing the initial (highlighted)
  1868.     letter of each. We will deal with these one at a time;
  1869.  
  1870.     Dial
  1871.  
  1872.     This causes COSWORTH to start dialling (surprisingly enough!) the
  1873.     currently selected entry. On doing so, the dialling directory will be
  1874.     replaced with the dialling screen which will show all command strings
  1875.     being sent to the modem. A status line will appear at the bottom of
  1876.     the screen showing the remaining dial time for each connection at the
  1877.     lower right corner. More about dialling and being on line in a
  1878.     minute... You can also start dialling by pressing the return key when
  1879.     the scroll bar is over the entry for the remote system you wish to
  1880.     contact. Incidentally, if you attempt to dial a blank entry which has
  1881.     just been created with the Insert or New commands then you will be
  1882.     forced to edit that entry instead. But more about editing dialling
  1883.     directories in a minute as well..
  1884.  
  1885.     Insrt
  1886.  
  1887.     This will insert a blank entry into the dialling directory at the
  1888.     point currently highlighted by the scroll bar. You can also select
  1889.     this with the insert key.
  1890.  
  1891.     Create
  1892.  
  1893.     A new blank dialling directory will be created on your disk.
  1894.  
  1895.     Edit
  1896.  
  1897.     This will cause you to edit the dialling directory entry currently
  1898.     highlighted. We'll cover this in detail in a minute!
  1899.  
  1900.     Copy
  1901.  
  1902.     A new entry will be inserted immediately after the current entry and
  1903.     the current highlighted entry will be copied into the new entry. This
  1904.     may be useful where you wish to associate numerous script files with
  1905.     one remote system.
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 29
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.     Manual
  1922.  
  1923.     If you select Manual dialling, a box will appear at the bottom of the
  1924.     screen asking you for a telephone number. Simply enter the telephone
  1925.     number into the box and press return. The number will then be dialled
  1926.     using the defaults as set up in the Directory Defaults section of the
  1927.     configuration section.
  1928.  
  1929.     Remove
  1930.  
  1931.     This will delete the entry currently highlighted by the scroll bar.
  1932.     You can also select this by pressing the delete key.
  1933.  
  1934.     Sort
  1935.  
  1936.     This will sort the dialling directory along one of three criteria; it
  1937.     can be sorted according to the names of the remote systems, the total
  1938.     time spent on line (with the longest first) or by the number of calls
  1939.     made to each system (again with the highest first). Alternatively, if
  1940.     you do not wish to sort the directory, select 'QUIT' or press escape.
  1941.  
  1942.     Print
  1943.  
  1944.     Unbelievable as it may seem, this option actually prints the dialling
  1945.     directory out onto paper. The print out will show each entry with all
  1946.     of its settings, together with a note of the total number of calls you
  1947.     have made and the total length of time you have been on line. Scary.
  1948.     Please ensure you have a printer attached to your computer first! If
  1949.     you don't, or if you have some other problem with the printer, then an
  1950.     error message will occur advising you that the printer is either out
  1951.     of paper, off line or busy, depending upon the circumstances.
  1952.  
  1953.     New
  1954.  
  1955.     This will append a blank entry to the end of the dialling directory.
  1956.  
  1957.     Load
  1958.  
  1959.     Selecting this option will bring up a scrolling directory box showing
  1960.     all the dialling directories on your disk. Simply move the highlight
  1961.     bar to the directory that you want to load and press return. The
  1962.     selected directory will then be loaded up.
  1963.  
  1964.     Zero
  1965.  
  1966.     This will reset the number of calls and total time on line back to
  1967.     zero. If you select this option you will be greeted a prompt saying;
  1968.  
  1969.           'Zero the highlighted entry, all entries or none? (H/A/N)'
  1970.  
  1971.     Pressing 'H' will cause the entry currently highlighted to be zeroed.
  1972.     Pressing 'A' will zero all entries in the dialling directory. Pressing
  1973.     'N' is effectively the same as pressing escape.
  1974.  
  1975.  
  1976.  
  1977.  
  1978.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 30
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.     Tag
  1988.  
  1989.     This will 'tag' the currently highlighted entry. A small marker will
  1990.     appear in the left hand margin showing that the entry has been tagged.
  1991.     By tagging entries in this manner you can cause COSWORTH to dial out
  1992.     to multiple systems in a queue, one after the other. You can also tag
  1993.     entries with the space bar.
  1994.  
  1995.     Untag
  1996.  
  1997.     Selecting this option will untag all tagged entries in the current
  1998.     directory.
  1999.  
  2000.  
  2001.     EDITING THE DIALLING DIRECTORY
  2002.     ------------------------------
  2003.  
  2004.     If you select 'Edit' from the main dialling directory, a window will
  2005.     pop up on the screen showing the settings for the current entry. The
  2006.     window looks like this;
  2007.  
  2008.           ┌───────────┤ EDIT CURRENT DIRECTORY ENTRY ├────────────┐
  2009.           │                                                       │
  2010.           │   Name            ALMAC BBS                           │
  2011.           │   Number          0324 665371                         │
  2012.           │   Password                                            │
  2013.           │   Script File     ALMAC                               │
  2014.           │   Dial Time       60                                  │
  2015.           │   Baud            2400                                │
  2016.           │   Parity          None                                │
  2017.           │   Stop Bits       1                                   │
  2018.           │   Data Bits       8                                   │
  2019.           │   Handshaking     XONXOFF                             │
  2020.           │   Prefix          1                                   │
  2021.           │   Terminal        ANSI                                │
  2022.           │   Protocol        Xmodem CheckSum                     │
  2023.           │   Local Echo      NO                                  │
  2024.           │   Add Line Feed   NO                                  │
  2025.           │   Dest. Backspace YES                                 │
  2026.           │                                                       │
  2027.           │                                                       │
  2028.           └────────────────────┤ ESC TO QUIT ├────────────────────┘
  2029.  
  2030.     There will be a highlight bar over the 'NAME' field and a box on the
  2031.     bottom line inviting you to enter the name of the current entry. you
  2032.     can move the highlight bar up and down the window with the arrow keys.
  2033.     As you do so, the prompt at the foot of the screen will change
  2034.     according to what field you are currently highlighting.
  2035.  
  2036.     The fields are either edited using a text entry line, as in the 'NAME'
  2037.     field, or through a multiple choice selection menu. If you wish to
  2038.     record your amendment, press return, otherwise press an arrow key to
  2039.     move to a new field and leave the old field unaltered. We shall deal
  2040.     with each of the fields separately;
  2041.  
  2042.  
  2043.  
  2044.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 31
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.     Name
  2054.  
  2055.     All you have to enter here is the name of the remote system. You are
  2056.     allowed up to thirty characters for this field.
  2057.  
  2058.     Number.
  2059.  
  2060.     Here you have to enter here is the telephone number for the remote
  2061.     system. You are allowed up to twenty characters for this field. If you
  2062.     are a subscriber to Mercury Communications then prefixing the number
  2063.     with the letter 'M' will cause the connection to be made via Mercury,
  2064.     assuming that you have defined your Mercury code in the configuration,
  2065.     that is! Please note that it is *not* recommended you make local calls
  2066.     via Mercury. At the time of writing, routing local calls through
  2067.     Mercury costs about 2½ times as much as British Telecom.
  2068.  
  2069.     Password
  2070.  
  2071.     Enter the password you use on the remote system, if any. This will be
  2072.     used to replace the *PASSWORD variable in script files. You are
  2073.     allowed up to fifteen characters for this field.
  2074.  
  2075.     Script File
  2076.  
  2077.     Enter the name of the associated script file, if any, you wish run
  2078.     when calling the remote system. A couple of points to make here;
  2079.     although script files all have the file extension '.SPT' do NOT enter
  2080.     this, only the first portion of the file name. Also, if you enter the
  2081.     name of a script file which does not exist in the script file
  2082.     directory (as defined in the configuration menu) then COSWORTH will
  2083.     assume that you wish to learn it and will create it for you the first
  2084.     time you connect to the remote system. See the section of this manual
  2085.     on script files for more information. You are allowed eight characters
  2086.     for the script file name.
  2087.  
  2088.     Dial Time
  2089.  
  2090.     This is the length of time in seconds that COSWORTH will take between
  2091.     dialling the telephone number for the remote system and hanging up to
  2092.     try again. Enter a value between 1 and 255. Note that you can manually
  2093.     intervene when dialling out. If you find that your dial time is too
  2094.     short, pressing the up and down arrow keys will temporarily increase
  2095.     or decrease the dialling time respectively. But more about that later
  2096.     as well.....!
  2097.  
  2098.     Baud
  2099.  
  2100.     This is the speed at which the remote system operates. If you have
  2101.     elected to operate with a locked port (in the modem strings
  2102.     configuration section) then this should be set to the highest speed at
  2103.     which the RS232 port on your computer can operate reliably. You will
  2104.     be presented with a multiple choice menu along the foot of the screen
  2105.     like this;
  2106.  
  2107.     Enter baud : 300 1200 2400 4800 7200 9600 12000 14400 19200 38400 57600
  2108.  
  2109.  
  2110.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 32
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.     Move the highlighted box along the line with the left and right arrow
  2120.     keys until you reach the required baud rate and then press return to
  2121.     select it.
  2122.  
  2123.     Parity
  2124.  
  2125.     Enter the required parity setting for the remote system. You will be
  2126.     presented again with a multiple choice menu like this;
  2127.  
  2128.               Enter parity :  Space   Odd   Mark   Even   None
  2129.  
  2130.     Move the highlighted box along the line with the left and right arrow
  2131.     keys until you reach the required parity setting and then press return
  2132.     to select it.
  2133.  
  2134.     Stop Bits
  2135.  
  2136.     Enter the required number of stop bits for the incoming data from the
  2137.     remote system. Again, you will be presented with a multiple choice
  2138.     menu like this;
  2139.  
  2140.                           Enter stop bits :  1   2
  2141.  
  2142.     Move the highlighted box along the line with the left and right arrow
  2143.     keys until you reach the required number of stop bits and then press
  2144.     return to select it.
  2145.  
  2146.     Data Bits
  2147.  
  2148.     Enter the required number of data bits for the incoming data from the
  2149.     remote system. Again, you will be presented with a multiple choice
  2150.     menu like this;
  2151.  
  2152.                           Enter data bits :  7   8
  2153.  
  2154.     Move the highlighted box along the line with the left and right arrow
  2155.     keys until you reach the required number of data bits and then press
  2156.     return to select it.
  2157.  
  2158.     Handshaking
  2159.  
  2160.     Enter the handshaking (or flow control) you require. You can select
  2161.     from one either None, Rts/Cts (also known as hardware handshaking) or
  2162.     Xon/Xoff (also known as software handshaking). Hardware handshaking is
  2163.     generally reserved for high speed modems and locked RS232 ports.
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 33
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.     Prefix
  2186.  
  2187.     Select which dialling prefix is to be used with the remote system.
  2188.     These are the strings to be sent to your modem immediately prior to
  2189.     the telephone number. As a reminder of what prefixes you have set up,
  2190.     a further small window will appear on the screen containing each of
  2191.     your current prefixes. Your prefixes will normally (if you have a
  2192.     Hayes compatible modem) start with 'AT' and terminate with either 'DT'
  2193.     for tone dialling or 'DP' for pulse dialling. Between these characters
  2194.     you can place any further modem commands, such as those which activate
  2195.     or deactivate error correction, handshaking options, duplexing or
  2196.     whatever else you wish. There are five prefixes defined in order to
  2197.     allow maximum flexibility.
  2198.  
  2199.     Terminal
  2200.  
  2201.     Select the method of terminal emulation you require from either
  2202.     TELETYPE or ANSI. Teletype is just a case of sending everything that
  2203.     comes in through your serial port onto the screen. It's pretty basic.
  2204.     ANSI, on the other hand, gives full emulation of ANSI commands EXCEPT
  2205.     the ESC[=Psh command which sets the graphic mode, since this could
  2206.     play merry hell with COSWORTH's output! Select whichever terminal
  2207.     emulation you have configured the remote system for. Also note that
  2208.     you can temporarily change the setting when on line as well, but more
  2209.     about that in a minute as well...!
  2210.  
  2211.     Protocol
  2212.  
  2213.     This defines the default file transfer protocol which will be used on
  2214.     this system. This is the protocol which will be first highlighted in
  2215.     the protocol menu (yes, that in a minute too!) when you start to
  2216.     download or upload a file. It will also be the protocol used when the
  2217.     script file encounters a DOWNLOAD or UPLOAD command whilst connected
  2218.     to this remote system. Choose YES if you wish to alter the default
  2219.     protocol. You will be presented with a menu listing all your installed
  2220.     protocols. Choose the new one using the scroll bar and the return key.
  2221.  
  2222.     Local Echo
  2223.  
  2224.     If you choose YES to this option then every character you type will be
  2225.     written to the screen and sent to the modem. This is only normally
  2226.     selected for terminal to terminal connections, since most bulletin
  2227.     boards will echo your characters back at you.
  2228.  
  2229.     Add Line Feed
  2230.  
  2231.     If you choose YES to this option then every return character you
  2232.     receive will cause a line feed to be added. Again, this is only
  2233.     normally selected for terminal to terminal connections, since most
  2234.     bulletin boards will automatically add line feeds for you.
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 34
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.     Dest. Backspace
  2252.  
  2253.     If you choose YES to this option then typing a backspace whilst on
  2254.     line will be 'destructive' in that it will delete the immediately
  2255.     preceding character and move the cursor back to that point, exactly
  2256.     like the DOS command line. If you select NO then a non-destructive
  2257.     backspace will be enabled which will only move the cursor back without
  2258.     overwriting the preceding characters.
  2259.  
  2260.     Once you are satisfied that you have made all the changes you wish,
  2261.     pressing escape will cause the prompt
  2262.  
  2263.                        Save this directory entry? (Y/N)
  2264.  
  2265.     to appear at the foot of the screen. If you press 'Y' then the
  2266.     dialling directory will be updated with your changes. If you press 'N'
  2267.     then the editing session will abort and no changes will be made.
  2268.  
  2269.  
  2270.     DIALLING AND CONNECTING
  2271.     -----------------------
  2272.  
  2273.     If you press 'D' for dial or return when in the dialling directory,
  2274.     you will start to dial the highlighted system. Here's what happens;
  2275.  
  2276.     First of all, you can hit either escape or the space bar during the
  2277.     dialling procedure. Hitting escape will abort the dialling process
  2278.     altogether and will return you to the dialling directory. Hitting the
  2279.     space bar will have one of two effects; if you have several numbers
  2280.     'queued' by tagging them in the dialling directory then the current
  2281.     entry being dialled is aborted and goes to the back of the queue. The
  2282.     next number in the queue will then be dialled. On the other hand, if
  2283.     you are only dialling one number then the current attempt at
  2284.     connecting to it is aborted and the process will restart.
  2285.  
  2286.     COSWORTH will first attempt to detect whether or not you have a live
  2287.     and working modem attached to your serial port. If you don't then an
  2288.     error (error #10, to be exact) will flash on the screen and you will
  2289.     be sent back to the dialling directory. If you DO have a working modem
  2290.     on the serial port in question (and you have specified the correct
  2291.     port, of course!) and this error occurs then try restarting COSWORTH
  2292.     with the /NOCHECKING command line switch. Auto checking like this does
  2293.     not work with all modems. See the errors section of this manual for
  2294.     more advice on this situation.
  2295.  
  2296.     The next thing to happen is that COSWORTH will check for the presence
  2297.     of a resident Fossil driver. If it finds that a Fossil driver has been
  2298.     loaded then an error stating 'RESIDENT FOSSIL DRIVER DETECTED - PORT
  2299.     MAY NOT BE INITIALISED CORRECTLY!' is shown on the screen.
  2300.     Occasionally, a resident fossil will hold the baud rate of the port to
  2301.     that which it has been set and will not allow further initialisation
  2302.     of the port to proceed. However, this error will only flag the
  2303.     presence of the Fossil driver - it will not prevent the port
  2304.     initialisation from proceeding.
  2305.  
  2306.  
  2307.  
  2308.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 35
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.     After this, COSWORTH will attempt to detect and disable FIFO buffering
  2318.     found in 16550A UART chips, on the selected serial port. If the
  2319.     buffering is left active then COSWORTH will not be able to initialise
  2320.     the port at all. After this, the port will be initialised using the
  2321.     required baud, parity, stop and data bits, following which FIFO
  2322.     buffering will be re-enabled.
  2323.  
  2324.     Next the string you have specified as 'RESET' in the modem strings
  2325.     configuration is sent to your modem and a response is awaited. If the
  2326.     response is your defined 'MODEM ERROR' string then an error message
  2327.     will be displayed, all queued dialling will be aborted (since your
  2328.     modem is not going to be initialised by any successive call) and the
  2329.     dialling process is terminated. However, if you receive the defined
  2330.     'MODEM OK' string then the 'INITIALISATION' string you have specified
  2331.     is sent to initialise the modem to the settings you require, which
  2332.     will again await either the 'MODEM OK' or 'MODEM ERROR' strings as
  2333.     before. After a response to this has been received, the dialling
  2334.     prefix you have specified will be sent to your modem, followed by the
  2335.     Mercury code (if required) followed by the number you wish to dial.
  2336.     The right hand side of the status line at the foot of the screen will
  2337.     show a decreasing counter showing the number of seconds of dialling
  2338.     time you have remaining. If you wish to temporarily alter this,
  2339.     pressing the up arrow key will increment the dialling time by five
  2340.     seconds and pressing the down arrow will decrement this value by five
  2341.     seconds. You cannot increment this value beyond 255 nor decrement it
  2342.     below zero. (obviously!) You ought to be able to hear your modem
  2343.     dialling the number (if you have a loudspeaker fitted to it) and then
  2344.     hear the appropriate telephone line signals of either ringing, engaged
  2345.     or, if you're just plain unlucky, disconnected!
  2346.  
  2347.     At this stage one of several things may occur. If the line is ringing
  2348.     and continues to do so beyond the dialling time then the words
  2349.     'DIALLING TIMED OUT' will appear on your screen and the dialling
  2350.     process will recommence. If the line is busy then the appropriate
  2351.     string returned by your modem on receiving an engaged line will be
  2352.     returned ONLY IF IT IS DEFINED IN THE 'BUSY STRINGS' SECTION OF THE
  2353.     MODEM CONTROL STRINGS IN THE CONFIGURATION MENU! If you haven't
  2354.     defined it then COSWORTH will not be able to recognise nor interpret
  2355.     the current situation. This string is usually 'BUSY'. Consult your
  2356.     modem documentation for this. (Note : if your modem supports higher
  2357.     'X' result code commands then it will probably be able to detect the
  2358.     fact that the line is engaged prior to the dialling period timing out.
  2359.     Use these higher codes whenever possible - they will save you time)
  2360.     If the line is ringing but no answer is made then the dialling period
  2361.     will simply time out and recommence.
  2362.  
  2363.     If, however, the line is answered by the remote modem (and hopefully
  2364.     not some sleepy human being) then you ought to hear your modem
  2365.     'talking' briefly to the other one. After this, you ought to receive
  2366.     what is known as the 'connect string'. For this to be received
  2367.     properly, COSWORTH must know what the connect string looks like. If
  2368.     the connect strings are not set up properly in the modem control
  2369.     strings section of the configuration menu then COSWORTH will assume
  2370.     that no connection was made and the dialling process will recommence
  2371.     after timing out.
  2372.  
  2373.  
  2374.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 36
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.     Assuming, though, that all is well and the connection is made, you
  2384.     will see the connect string displayed on the screen followed by a
  2385.     brief tune announcing the connection. (if you have the sounds enabled)
  2386.     If you are contacting a system that you have never connected to
  2387.     before, then COSWORTH will automatically ask you if you want to open a
  2388.     capture file. This may be useful since some systems show special
  2389.     information to new users and you may want to refer to it at a later
  2390.     date.
  2391.  
  2392.     After that you are connected to the remote system and you are
  2393.     communicating with the software being run by that system. A sample
  2394.     connection screen might look like this;
  2395.  
  2396. -----------------------------------------------------------------------------
  2397. CONNECT 14400/ARQ/V32/MNP
  2398.   ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  2399.   █            ┐   ┐ ┌──  ┐   ┌──  ┌──┐ ┌─┬─┐ ┌──        ┌─┬─┐ ┌──┐          █
  2400.   █            │   │ ├    │   │    │  │ │   │ ├            │   │  │          █
  2401.   █            └─┴─┘ └──  └── └──  └──┘ ┘   ┘ └──          ┘   └──┘          █
  2402.   █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  2403.   ███ ▄▄▄▄▄▄▄  ▄      ▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄  ▄▄▄▄▄                              ███
  2404.   ███ █     █  █      █  █  █  █     █  █                                   ██
  2405.   ███ █▀▀▀▀▀█  █      █     █  █▀▀▀▀▀█  █      ┌───┐  ┌───┐  ┌───┐          ██
  2406.   ███ █     █  █      █     █  █     █  █      │ ──┴┐ │ ──┴┐ └───┐          ██
  2407.   ███ ▀     ▀  ▀▀▀▀▀▀ ▀     ▀  ▀     ▀  ▀▀▀▀▀  └────┘ └────┘ └───┘  Ltd.    ██
  2408.   ████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄██
  2409.   ███████████████  SysOps : Mark Anderson,  Alastair McIntyre    ▀████████████
  2410.   ████████████████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄████████████
  2411.   ███████████████                                                █████████████
  2412.   ███████████████  Heathpark            Tel: +44 (0)324 666336   █████████████
  2413.   ███████████████  141 Bo'ness Rd       Fax: +44 (0)324 665155   █████████████
  2414.   ███████████████  Grangemouth                                   █████████████
  2415.   ███████████████  FK3 9BS              PC Board S/n 0011123     █████████████
  2416.   ███████████████                                                █████████████
  2417.   ████████████████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄████████████
  2418.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2419.  
  2420. What is your first name?
  2421.  ALMAC BBS                  │CONNECT 14400│L19200 8-N-1│00:00:09│18:55:32│CS
  2422. -----------------------------------------------------------------------------
  2423.  
  2424.     In this example, the connect string received is shown at the top of
  2425.     the screen as 'CONNECT 14400/ARQ/V32/MNP' which indicates the speed of
  2426.     the connection and the error correction method being employed. Your
  2427.     modem may not support many of these features so don't get worried if
  2428.     they don't appear!
  2429.  
  2430.     Beneath that comes the body of the text being received from the remote
  2431.     system, as text is received down the line it is shown on the screen
  2432.     using whatever terminal emulation you specified. As more text comes
  2433.     in, the existing text scrolls off the top of the screen.
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 37
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.     The bottom line (line 25) of the screen does not come from the remote
  2450.     system. It is the status bar which tells you something about how
  2451.     COSWORTH is operating and what the line connection rate is. The left
  2452.     hand portion of the status line shows the name of the system you are
  2453.     connected to. The next portion shows the connection speed as taken
  2454.     from the connect string. The next portion shows the port status - in
  2455.     the above case the user would have been operating with a serial port
  2456.     locked at 19200 baud, signified by the 'L' character preceding the
  2457.     baud rate. If the port was unlocked then the port baud rate setting
  2458.     ought to match that of the connection speed. The 8-N-1 portion
  2459.     summaries the bit settings of the incoming data,m in this case 8 bits,
  2460.     no parity and 1 stop bit. After this appear two clocks; the one on the
  2461.     left shows the length of time that you have been on line for and the
  2462.     one on the right shows the time of day. The last three character
  2463.     spaces (although only two characters are being shown in this example)
  2464.     tell you something about the way COSWORTH is actually operating. The
  2465.     left character shows you the capture file status. This can be either
  2466.     'C' indicating a capture file is active and operating, 'U' indicating
  2467.     that the capture file is active but has been suspended or nothing at
  2468.     all indicating that (go on, have a guess...) no capture file is being
  2469.     used. The second character tells you something about the status of the
  2470.     script file in use. This could be either 'S' if a script file is being
  2471.     used, 'L' if a script file is being learned, 'A' if you are in auto
  2472.     dialler mode (since you can't connect using the auto dialler facility
  2473.     without a script file!) or blank if no script file is being used at
  2474.     that time. The last character is a 'P' if a printer capture is
  2475.     activated or blank otherwise.
  2476.  
  2477.     Once you are on line and connected you are not entirely at the mercy
  2478.     of the remote system! There are various keystrokes which you can use
  2479.     to alter the way COSWORTH is operating or change the manner in which
  2480.     the incoming data is being displayed. The keystrokes are mostly two
  2481.     key combinations such as ALT-A which mean you have to hold down the
  2482.     'ALT' key and press the 'A' key whilst still holding the 'ALT' key
  2483.     down. We kind of hoped you would know that but God knows, you have to
  2484.     document everything these days.
  2485.  
  2486.     The keystrokes available to you are as follows;
  2487.  
  2488.     ALT-A   Abandon the current script file if you are currently running
  2489.             one. The 'S' will disappear from the right hand corner of the
  2490.             status line and every keystroke will be up to you from that
  2491.             point. This may be useful if you wish to do more whilst on line
  2492.             than your script file normally allows.
  2493.  
  2494.     ALT-B   Send a BREAK signal to the remote system. This is required by
  2495.             some host systems to do certain tasks like ending
  2496.             transmissions.
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 38
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.     ALT-C   Change the capture file status. If a capture file is not
  2516.             running then you will be asked if you want to start one. If you
  2517.             reply that you do then you will be prompted for the name of the
  2518.             capture file to create. If that file already exists then it
  2519.             will be appended to, if it doesn't exist then it will be
  2520.             created.This file name defaults to COSWORTH.CAP. If a capture
  2521.             file is running then you will be asked whether you want to stop
  2522.             it or to suspend it temporarily. If a capture file has been
  2523.             suspended then you will be asked whether you want to reactivate
  2524.             it or not. In any event, the keys to press in response are
  2525.             shown in brackets in the information box that appears on
  2526.             pressing this keystroke.
  2527.  
  2528.     ALT-D   Shell to DOS temporarily. The screen will clear and you will
  2529.             find yourself in a DOS session. To remind you that you are on
  2530.             line, the DOS prompt will change from your normal prompt into
  2531.             the rather alarming '[CW ON-LINE!] $p$g'. To re-enter COSWORTH,
  2532.             type EXIT <return> at the DOS prompt and you will find yourself
  2533.             at exactly the same position you were in before you shelled
  2534.             out.
  2535.  
  2536.     ALT-E   Toggle local echo on or off. Local echo will cause every
  2537.             character you type to be sent to the modem and written to the
  2538.             screen.
  2539.  
  2540.     ALT-F   Terminate script file learning mode. If you are learning a
  2541.             script file then you need not continue to do so until you log
  2542.             off. The script file will be closed and saved off to disk.
  2543.  
  2544.     ALT-H   Hang up. Pressing ALT-H will pop up a small box asking you to
  2545.             confirm that you wish to hang up. If you confirm that you wish
  2546.             to do so, the carrier will be dropped and the session
  2547.             terminated. NOTE: Do NOT do this whilst in the middle of a
  2548.             session with a bulletin board unless there is no other option.
  2549.             Most system operators (sysops) give more than a little irked at
  2550.             people 'hopping on' and 'hopping off' in this manner, since
  2551.             their software may not always stand up to this manner of
  2552.             dropping carrier. Unless the remote software has locked up or
  2553.             there is no other manner of logging off (which unlikely) always
  2554.             log off using the manner which the remote software gives you.
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 39
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.     ALT-K   Kill an auto dialler session. If you have connected
  2582.             using the Auto Dialler facility, then pressing ALT-K will cause
  2583.             the Auto Dialler session (for the current connection only) to
  2584.             be terminated. Note that the script file running will not be
  2585.             terminated and will continue until aborted with the ALT-A
  2586.             keystroke. The reason for the ALT-K keystroke is this; if it is
  2587.             obvious that a script file is going awry or if you simply want
  2588.             to interrupt the script then aborting it with ALT-A will,
  2589.             during an Auto Dialler session, cause COSWORTH to think that
  2590.             the script terminated prematurely and will drop carrier, as
  2591.             part of the inbuilt protection against Auto Dialler sessions
  2592.             leaving you on line for lengthy periods. By pressing ALT-K,
  2593.             this problem can be circumvented by simply telling COSWORTH
  2594.             that the current connection must not be considered as an Auto
  2595.             Dialler connection.
  2596.  
  2597.     ALT-L   Toggle additional line feeds on or off.
  2598.  
  2599.     ALT-M   Modify the display type. This will pop up a small box asking
  2600.             you which of Teletype or ANSI terminal emulation you require.
  2601.             Pressing the initial letter of the display type (either T or A)
  2602.             will invoke that particular terminal emulation type.
  2603.  
  2604.     ALT-N   Insert a note in the log file, if one is enabled. A small box
  2605.             will pop up inviting you to enter a line of text to be inserted
  2606.             in the log file. Once you have edited the line to your
  2607.             satisfaction, pressing enter will place that line into your log
  2608.             file. See the section on COSWORTH's ancillary files for more
  2609.             details on the log file.
  2610.  
  2611.     ALT-P   Toggles printer capture on or off.
  2612.  
  2613.     ALT-R   Toggles the presence or absence of the status line. If a
  2614.             status line is enabled then pressing ALT-R will cause the whole
  2615.             screen to be used by the incoming data. Pressing ALT-R again
  2616.             will cause the status line to reappear.
  2617.  
  2618.     ALT-S   Take a snapshot of the current screen. The entire contents of
  2619.             the screen (but not the status line) will be captured and
  2620.             stored in the COSWORTH.SNP snapshot file.
  2621.  
  2622.     ALT-T   Toggles destructive backspace on and off.
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 40
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.     ALT-U   Upload a prepared text file. If you have to send messages over
  2648.             a bulletin board then preparing the text offline (ie, whilst
  2649.             not actually connected) can go some way to reducing your
  2650.             telephone costs. Instead of typing your messages into a text
  2651.             editor found on a bulletin board, enter the menu as per normal
  2652.             and press ALT-U. A small box will appear asking you for the
  2653.             name of the file containing your prepared text. Either type the
  2654.             name in and press enter, or press enter on the blank line and a
  2655.             scrolling directory listing will appear, allowing you to select
  2656.             the file you wish to upload. Once you have selected or entered
  2657.             the name of the file, COSWORTH will read the contents of the
  2658.             file in a line at a time and send it to the remote system. This
  2659.             will continue until either then end of the file has been
  2660.             reached or you have aborted the process by pressing the escape
  2661.             key.
  2662.  
  2663.     ALT-X   Send an XOFF character to the remote system. It is possible
  2664.             that spurious characters generated by line noise may send an
  2665.             XON character which may give you the impression that the
  2666.             connection has 'hung'. If you experience this, you may be able
  2667.             to resume the connection by pressing sending an XOFF
  2668.             character.
  2669.  
  2670.     PageUp  Commence the file uploading process. This will invoke an
  2671.             external protocol and will allow you to transfer files to the
  2672.             remote system. Initially, a scrolling menu will appear asking
  2673.             you to select the required transfer protocol. The highlighted
  2674.             entry in the menu will initially be the default protocol as
  2675.             entered in the dialling directory entry for the remote system,
  2676.             although any other protocol can be used, as long as the remote
  2677.             system knows which protocol you are using and is using it too.
  2678.             After you have selected the protocol, the next part is
  2679.             dependent on the upload command line you have defined for the
  2680.             protocol. If you have specified the COSWORTH system variable
  2681.             '*FNAME' in the command line then a box will appear asking you
  2682.             for the name of the file to be uploaded. The box will be
  2683.             pre-filled with the last file name that appeared on the screen.
  2684.             (since the remote software has probably either asked you to
  2685.             type in the actual file name or knows it in advance, prompting
  2686.             you with something like 'ABOUT TO RECEIVE YOURFILE.ZIP') Either
  2687.             press return on the input line on the screen or retype the name
  2688.             of the file if it is wrong. You can also delete the name of the
  2689.             file in the box and press enter on the blank line to bring up a
  2690.             scrolling directory box which will show you the current
  2691.             contents of your upload directory, as defined in the paths
  2692.             section of the configuration menu. You can then select the file
  2693.             that you wish to upload - the menu will also allow you to move
  2694.             across directories, thereby allowing you to upload any file you
  2695.             have on your disk. Once you have selected or entered the name
  2696.             of the file, the external protocol will execute. If a non-zero
  2697.             errorlevel is returned by the external protocol then an error
  2698.             message will be generated advising you of a possible problem
  2699.             with the transfer. After the transfer has completed AND ONLY IF
  2700.             YOU HAVE RECEIVED A ZERO ERRORLEVEL FROM THE PROTOCOL PROGRAM
  2701.             (usually meaning that all went well with the protocol transfer)
  2702.  
  2703.  
  2704.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 41
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.             then COSWORTH will inspect the file masks you have specified in
  2714.             the Mail Files section of the configuration menu. If the file
  2715.             you have just uploaded matches any of these file masks then -
  2716.             if a script file is not running - a box will pop up asking you
  2717.             if you wish to delete the file just uploaded. If you press 'Y'
  2718.             then the file will be deleted, pressing 'N' will leave it
  2719.             alone. After this, the transfer section is over and you will be
  2720.             returned to the session where you left off.
  2721.  
  2722.     PageDN  Commence the file downloading process. This will invoke an
  2723.             external protocol and will allow you to transfer files from
  2724.             the remote system. Initially, a scrolling menu will appear
  2725.             asking you to select the required transfer protocol. The
  2726.             highlighted entry in the menu will initially be the default
  2727.             protocol as entered in the dialling directory entry for the
  2728.             remote system, although any other protocol can be used, as
  2729.             long as the remote system knows which protocol you are using
  2730.             and is using it too. After you have selected the protocol, the
  2731.             next part is dependent on the upload command line you have
  2732.             defined for the protocol. If you have specified the COSWORTH
  2733.             system variable '*FNAME' in the command line then a box will
  2734.             appear asking you for the name of the file to be downloaded.
  2735.             The box will be pre-filled with the last file name that
  2736.             appeared on the screen. (since the remote software has
  2737.             probably either asked you to type in the actual file name or
  2738.             knows it in advance, prompting you with something like 'ABOUT
  2739.             TO SEND YOURFILE.ZIP') You must then enter the name of the
  2740.             file being downloaded and press return. Once you have entered
  2741.             the name of the file, the external protocol will execute. If a
  2742.             non-zero errorlevel is returned by the external protocol then
  2743.             an error message will be generated advising you of a possible
  2744.             problem with the transfer. After this, the transfer section is
  2745.             over and you will be returned to the session where you left
  2746.             off.
  2747.  
  2748.     F1      Shows a help screen summarising all the available keystrokes.
  2749.             It will also show you the password you have allocated for that
  2750.             connection - useful for those with short memories!
  2751.  
  2752.     F2      Shows a summary of all the keystroke macros you have defined.
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 42
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.     In addition to the above keystrokes, there is one other very important
  2780.     keystroke which may be useful under certain circumstances.
  2781.  
  2782.     ALT-=   This keystroke disables ALL the above keystrokes. Why use
  2783.             this? Simply because it may occur that you will require one of
  2784.             these keystrokes for another purpose. it may also be that you
  2785.             have certain privileges on the system you are calling and have
  2786.             the ability to shell to DOS or run external programs such as
  2787.             text editors.This may require you to have keys such as F1 or
  2788.             any of the ALT key combinations available. By pressing ALT-=
  2789.             all the above COSWORTH keys will be temporarily disabled
  2790.             allowing you to use them for other purposes. The only COSWORTH
  2791.             keystroke which remains in force is ALT-= itself which will
  2792.             allow you to reset all the above keystrokes to their uses
  2793.             within COSWORTH.
  2794.  
  2795.     Once you have completed your session, the carrier will be dropped and
  2796.     you will either be returned to the dialling directory if you were only
  2797.     dialling one number, or else the next number will be dialled if you
  2798.     have a series of connections queued for dialling.
  2799.  
  2800.     On exiting back to the dialling directory the figures for the number
  2801.     of calls and total time spent on line for each system you have been
  2802.     contacted will be incremented by the appropriate amount.
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.     COSWORTH COMMUNICATIONS SOFTWARE - The Dialling Directory       page 43
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.     SCRIPT FILES
  2846.     ------------
  2847.  
  2848.     COSWORTH has a script language built into it which may take much of
  2849.     the effort out of repetitive tasks when on line, such as entering your
  2850.     name, password and so on.
  2851.  
  2852.     What is a script file? In its simplest format, it is somewhat similar
  2853.     to a DOS batch file, containing a list of prompts which your software
  2854.     will 'expect' to receive from the remote system, and a list of replies
  2855.     that it will send when it receives these prompts. Script files can
  2856.     automate the usage of COSWORTH to the extent that little or no
  2857.     intervention may be needed from you when logging on.
  2858.  
  2859.     Obviously, this will require some knowledge of the system you are
  2860.     contacting and the prompts it uses. However, much of the work in
  2861.     creating script files can be avoided by using COSWORTH's ability to
  2862.     learn and create script files as it goes along, without any
  2863.     intervention from you at all!
  2864.  
  2865.     Aside from 'learn' facility within COSWORTH, script files can also be
  2866.     created by using any text editor or word processor capable of
  2867.     outputting plain ASCII text without any control characters or
  2868.     tabulations. If you haven't got a text editor then ensure your word
  2869.     processor is set to 'non-document' mode in order to save the script
  2870.     file out as ASCII. If you are unsure if your word processor can do
  2871.     this, edit a short (say, ten line) file in your word processor, save
  2872.     it out as TEST.DOC and exit to DOS. If, when you issue the DOS command
  2873.     'TYPE TEST.DOC', you see your file jumbled up with odd characters that
  2874.     you didn't type then you can be fairly sure that either your word
  2875.     processor isn't set up properly or else it is incapable of saving
  2876.     plain ASCII text. Almost any text editor will fit the bill -
  2877.     personally, we use the excellent QEDIT by SemWare - but just about any
  2878.     one will do.
  2879.  
  2880.     Before explaining how script files actually work, let's list all the
  2881.     available COSWORTH script file commands and their meanings;
  2882.  
  2883.     RECEIVE <string>   COSWORTH will wait until string specified is
  2884.                        received. If the string is not received by COSWORTH
  2885.                        within the length of time specified by you in the
  2886.                        'Default script time out' entry in the Program
  2887.                        Settings menu then the script will time out and
  2888.                        abort, although you will still remain on line. The
  2889.                        string you specify may be either in single quotes
  2890.                        (RECEIVE 'What is your name?'), double quotes
  2891.                        (RECEIVE "What is your name?") or in no quotation
  2892.                        marks at all. (RECEIVE What is your name?)
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 44
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.     SEND <string>      COSWORTH will send the specified string to the
  2912.                        remote system. The string you specify may be either
  2913.                        in single quotes (SEND 'Joe Bloggs'), double quotes
  2914.                        (SEND "Joe Bloggs") or in no quotation marks at all.
  2915.                        (SEND Joe Bloggs) However, if you do not specify any
  2916.                        string in the script, and instead use the key word
  2917.                        INPUT (SEND INPUT) then a box will pop up on the
  2918.                        screen allowing you to type in whatever it is you
  2919.                        want sent to the remote system.
  2920.  
  2921.     WAIT <seconds>     Your script file will wait for the number of seconds
  2922.                        specified before timing out. Effectively, this is a
  2923.                        way to increase the default script time out that you
  2924.                        have set up in the Program Settings menu,
  2925.                        on-the-fly. Of course, using this command within a
  2926.                        script file will not permanently affect your set up.
  2927.                        This command is generally used prior to a RECEIVE
  2928.                        command in circumstances where your normal script
  2929.                        time out would be too short. Once the script file
  2930.                        encounters a WAIT it alters the time out period to
  2931.                        the length of time you have passed it in the
  2932.                        command, then goes on immediately to the next line.
  2933.                        If COSWORTH receives the RECEIVE string within the
  2934.                        period set up by the WAIT command then the script
  2935.                        time out period is reset back to the default,
  2936.                        otherwise the whole script file will time out as per
  2937.                        normal. If you pass NO parameters to the WAIT
  2938.                        command then it will WAIT indefinitely for the next
  2939.                        string to be received - handy if you are doing mail
  2940.                        (or other) downloads where you don't know quite how
  2941.                        long they will take.
  2942.  
  2943.     UPLOAD <filename>  Causes the file specified to be uploaded to the
  2944.                        remote system. The default protocol specified for
  2945.                        the remote system is used. By default, the file will
  2946.                        be taken from the directory you have specified as
  2947.                        the upload directory in the Paths menu. However, if
  2948.                        you specify a full qualified path name (for example,
  2949.                        C:\FILES\GAME.ZIP) then the file will be uploaded as
  2950.                        per the entire path name. If the file doesn't exist
  2951.                        then an error message will be generated.
  2952.  
  2953.     DOWNLOAD filename  Causes file specified to be downloaded from the
  2954.                        remote system. The default protocol specified for
  2955.                        the remote system is used. The file will be placed
  2956.                        into the directory you have set up as the download
  2957.                        directory in the Paths menu.
  2958.  
  2959.     DELETE filename    The file specified will be deleted, if it exists. If
  2960.                        the file doesn't exist then an error message will be
  2961.                        generated, although the script file will continue
  2962.                        to operate as normal.
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 45
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.     CAPTURE <on/off f> Turns a capture file on or off. An additional
  2978.                        second parameter (shown here as 'f') can be used to
  2979.                        specify the name of the capture file. If no name is
  2980.                        given for the capture file then the file will
  2981.                        default to the name COSWORTH.CAP. If the capture
  2982.                        file exists when turned on the it will be appended
  2983.                        to, otherwise it will be created. It is probably
  2984.                        easiest to specify a capture file name as 'MYCAP'
  2985.                        since as part of its verification features, COSWORTH
  2986.                        will not let you path a script file directed capture
  2987.                        file elsewhere and will not allow file extensions
  2988.                        other than '.CAP'. If you specify a file name such
  2989.                        as 'C:\CAPTURES\CAPFILE.1' then the script will
  2990.                        delete all extraneous information from the file name
  2991.                        and will create (or append to) a file called
  2992.                        CAPFILE.CAP within the program path as defined in
  2993.                        the configuration. A directive other than ON or OFF
  2994.                        will result in the CAPTURE instruction being
  2995.                        ignored.
  2996.  
  2997.     SOUND on/off       Turns sounds on or off. This might be useful for
  2998.                        late night work!
  2999.  
  3000.     MINIMUM SPEED <n>  This is really only specified for the Auto Dialler,
  3001.                        although you might want to use it within your
  3002.                        'normal' script files as well. It demands that the
  3003.                        connection be made at _at_least_ the baud rate
  3004.                        defined as 'n'. If not, then the connection will be
  3005.                        broken. This is useful for systems that suffer
  3006.                        badly from 'line noise' that causes the negotiated
  3007.                        baud rate to drop, sometimes dramatically, causing
  3008.                        the whole operation to slow up. If you pass anything
  3009.                        other than a numeric argument 'n' to the command
  3010.                        then it will be ignored. Note that, although this
  3011.                        command (like any other) can be placed at any point
  3012.                        in the script file, it only really 'makes sense' to
  3013.                        have it as the first command in the script. Also,
  3014.                        watch out for silly entries like MINIMUM SPEED
  3015.                        1000000!
  3016.  
  3017.     PAUSE <seconds>    This will _unconditionally_ pause the processing of
  3018.                        the script file for the length of time specified.
  3019.                        This command is useful within script files for some
  3020.                        systems that utilise some text file displaying
  3021.                        utilities that pause themselves for a couple of
  3022.                        seconds before accepting keystrokes. Whereas WAIT is
  3023.                        used to delay the receipt of a string prompt, PAUSE
  3024.                        should be used to delay the sending of a string once
  3025.                        the prompt is received. If a non-numeric argument is
  3026.                        passed to the command then the command will be
  3027.                        ignored.
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 46
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.     In additional to all the above, the script file also understands four
  3044.     internal COSWORTH variables. When placed in the script file, they will
  3045.     be read and expanded to their actual meaning. These variables are;
  3046.  
  3047.       *NAME      This is the full name as set up in the User's Name entry
  3048.                  in the Program Settings menu.
  3049.  
  3050.       *FIRST     This will return the Christian name extracted from the
  3051.                  User's Name entry in the Program Settings menu. Note that
  3052.                  if your name uses more than three 'words' (like 'Billie
  3053.                  Jean King') then *FIRST will only return the first word
  3054.                  extracted from the name. This is only to avoid an
  3055.                  ambiguity.
  3056.  
  3057.       *LAST      This will return the surname extracted from the User's
  3058.                  Name entry in the Program Settings menu. Note that if
  3059.                  your name uses more than three 'words' (like 'Rip Van
  3060.                  Winkle') then *LAST will only return the last word
  3061.                  extracted from the name. This is only to avoid an
  3062.                  ambiguity.
  3063.  
  3064.       *PASSWORD  This will be expanded to give the password you have
  3065.                  allocated to the remote system in the dialling directory.
  3066.  
  3067.       # (hash)   This is interpreted as a 'return' character.
  3068.  
  3069.       ^ (caret)  To insert control characters into your script files, use
  3070.                  the caret notation. For example, ^M is interpreted as
  3071.                  CTRL-M, which would insert a return character into your
  3072.                  script prompts or strings. To insert a caret into your
  3073.                  prompts use two carets together, as in ^^. Some of the
  3074.                  more familiar control characters are
  3075.  
  3076.                              ^M        CR        Carriage Return
  3077.                              ^J        LF        Line Feed
  3078.                              ^L        FF        Form Feed
  3079.                              ^[        ESC       Escape
  3080.  
  3081.                  NOTE: If you are using XON/XOFF handshaking then take
  3082.                  care not to include either ^Q (XON) or ^S (XOFF)
  3083.                  characters in your SEND strings as they will probably
  3084.                  disturb transmission!
  3085.  
  3086.     Anything that COSWORTH finds within a script file that it _doesn't_
  3087.     understand, it ignores. Also, you may freely add comments to the
  3088.     script file as long as occupy a line by themselves and are preceded by
  3089.     a semi colon character (;).
  3090.  
  3091.  
  3092.     HOW TO USE SCRIPT FILES
  3093.     -----------------------
  3094.  
  3095.     Script files MUST reside in the script directory as set up in the
  3096.     Paths menu. You cannot path a script file elsewhere.
  3097.  
  3098.  
  3099.  
  3100.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 47
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.     Using a script file you have created couldn't be easier. To cause a
  3110.     script file to be invoked merely enter the eight character name of the
  3111.     script file into the SCRIPT entry in the dialling directory. NOTE THAT
  3112.     ALL SCRIPT FILES HAVE THE FILE EXTENSION '.SPT'. Don't enter this,
  3113.     just the file's name. So, for instance, if you have a script file by
  3114.     the name of EAZIHOST.SPT and you want to associate this with your
  3115.     entry for FORTH VIEW BBS (as is done by the installation program) then
  3116.     edit the directory entry and include the name 'EAZIHOST' alongside the
  3117.     entry for 'Script File' and save it. Your dialling directory should
  3118.     then look something like this;
  3119.  
  3120.    FORTH VIEW BBS                │031 660 6680        │19200 │8-N-1│PC-BOARD
  3121.  
  3122.     Then just dial the number and the script file will start up. You can
  3123.     keep a check on the script file's 'status' by examining the bottom
  3124.     right corner of the status line. If a script file is currently in use
  3125.     then the centre character of the rightmost 'box' on the status line
  3126.     will be an 'S'. If the script is finished running or aborted (by
  3127.     pressing ALT-A when on line) then the character space will be blank.
  3128.     If, however, a script file is being learned by COSWORTH then this
  3129.     character will appear on the status line as an 'L'.
  3130.  
  3131.                 IMPORTANT - SCRIPT FILES *ARE* CASE SENSITIVE!
  3132.  
  3133.  
  3134.     LEARNING SCRIPT FILES
  3135.     ---------------------
  3136.  
  3137.     To force COSWORTH to learn a script file, just specify a NON-EXISTENT
  3138.     script file name in the dialling directory. COSWORTH will detect the
  3139.     fact that a script is being requested and will start creating the
  3140.     script file for you. You can abort the learning process at any time
  3141.     whilst on line by pressing ALT-F. Note that terminating the learning
  3142.     process like this will save the script file off to disk.
  3143.  
  3144.     There's one thing to remember when learning script file - don't learn
  3145.     scripts for systems you have never contacted before. You will
  3146.     generally find that most systems have a new set of procedures for new
  3147.     users and may take you through questionnaires and display 'first time'
  3148.     information to you. If you are learning a script file whilst doing
  3149.     this then you'll almost certainly find that it won't be right the
  3150.     second time! As a rule, don't specify scripts for new systems - leave
  3151.     them until the second time or after.
  3152.  
  3153.     Learned scripts will contain all the necessary commands required to
  3154.     emulate the 'learned' connection, with the notable exception of the
  3155.     PAUSE command, which cannot be learned. Since COSWORTH would have
  3156.     difficulty in detecting whether a remote system is accepting
  3157.     keystrokes at that time, PAUSE commands will have to be manually
  3158.     entered into your script file (if necessary) using your text editor.
  3159.     Similarly, it would be presumptuous of COSWORTH to add a MINIMUM SPEED
  3160.     directive to your scripts. If you require this command then it too
  3161.     will have to be manually edited into your script file.
  3162.  
  3163.  
  3164.  
  3165.  
  3166.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 48
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.     EXAMPLE SCRIPT FILE
  3176.     -------------------
  3177.  
  3178.     ;To demonstrate how to use COSWORTH's script language, here's a
  3179.     ;example of what you might find in a script file.
  3180.     ;This is a comment. You can add them freely throughout the file along
  3181.     ;as they are all preceded by a semi colon. The first thing this script
  3182.     ;does is check to see that the connection rate is fast enough to
  3183.     ;bother with! If the connection speed is too slow then the script will
  3184.     ;hang up the line for you.
  3185.  
  3186.     MINIMUM SPEED 9600
  3187.  
  3188.     ;And let's assume that it's late at night and people are trying to
  3189.     ;sleep!
  3190.  
  3191.     SOUND OFF
  3192.  
  3193.     ;Next, the script waits for the following prompt to be sent from the
  3194.     ;remote system before going any further. Note that the prompt (and
  3195.     ;ONLY the prompt!) can be enclosed in quotes, if you want.
  3196.  
  3197.     RECEIVE "Please enter your name : "
  3198.  
  3199.     ;Now that this prompt has been received, send back your reply. Notice
  3200.     ;that this uses the internal *NAME variable instead of you having to
  3201.     ;enter your full name in the script. It also appends a return
  3202.     ;character in the form of an interpreted '#'.
  3203.  
  3204.     SEND "*NAME#"
  3205.  
  3206.     ;Now the system asks for your password...
  3207.  
  3208.     RECEIVE "Please enter your password : "
  3209.  
  3210.     ;..and you send it back. Again, this example uses the *PASSWORD
  3211.     ;internal variable. This is good practice, since you may well change
  3212.     ;your password, thereby saving you re-editing the script. Notice also
  3213.     ;how the return character after the password is being passed in the
  3214.     ;carat control character format.
  3215.  
  3216.     SEND *PASSWORD^M
  3217.  
  3218.     ;Now let's say that the system has accepted your password and has
  3219.     ;logged you on. Imagine that it is now displaying a five second news
  3220.     ;bulletin that it forces you to read and NOT skip over. If you were to
  3221.     ;press a key then the system would ignore it, so...
  3222.  
  3223.     PAUSE 7
  3224.  
  3225.     ;...which stops the script running for seven seconds (allowing enough
  3226.     ;leeway) and then recommences.
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 49
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.     RECEIVE "What next? (U)pload, (D)ownload, (L)istings, (G)oodbye?"
  3242.  
  3243.     ;Okay, so it's a limited bulletin board..(!) You make your reply..
  3244.  
  3245.     SEND 'U#'
  3246.     RECEIVE "Waiting to receive file..."
  3247.  
  3248.     ;Now you'll start your upload of the file. Once it's uploaded you want
  3249.     ;to clear it out of your upload directory, so you delete it.
  3250.  
  3251.     UPLOAD COSWORTH.ZIP
  3252.     DELETE COSWORTH.ZIP
  3253.  
  3254.     ;Now, how long will it take to upload COSWORTH.ZIP? You won't really
  3255.     ;know unless you sit and work it out, and even then you might get it
  3256.     ;wrong. So the next command will prevent the command after it from
  3257.     ;'timing out'...
  3258.  
  3259.     WAIT 900
  3260.  
  3261.     ;...by causing the script to increase it's time out to 900 seconds.
  3262.     ;That way, the following RECEIVE command will work.
  3263.  
  3264.     RECEIVE "What next? (U)pload, (D)ownload, (L)istings, (G)oodbye?"
  3265.  
  3266.     ;Now that the above string has been received, the script time out is
  3267.     ;reset from 900 seconds back to your standard default. Imagine now
  3268.     that you want to have a look at the file listings on the remote
  3269.     system. You might want to turn a capture file on for this...
  3270.  
  3271.     CAPTURE ON C:\COSWORTH\FILELIST.CAP
  3272.     SEND "L#"
  3273.  
  3274.     ;Now the remote system is showing all the new files in its directory.
  3275.     ;Imagine that it has now done that and is displaying this...
  3276.  
  3277.     RECEIVE "What next? (U)pload, (D)ownload, (L)istings, (G)oodbye?"
  3278.  
  3279.     ;You'll want to turn the capture off here, so..
  3280.  
  3281.     CAPTURE OFF
  3282.     SEND "D#"
  3283.     RECEIVE "What file do you want to download?"
  3284.  
  3285.     ;..and then make a download. This uses the SEND INPUT format which
  3286.     ;will allow you to type in the characters to be sent to the remote
  3287.     ;system, in this case the name of the file that you want. After that
  3288.     ;you start your download. Note that some external protocols may
  3289.     ;require the file name to be passed to it.
  3290.  
  3291.     SEND INPUT
  3292.     RECEIVE "Sending file..."
  3293.     DOWNLOAD
  3294.  
  3295.  
  3296.  
  3297.  
  3298.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 50
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.     ;Again, you don't know how long this will take, so to be on the safe
  3308.     ;side, specify an unlimited waiting period before the next string is
  3309.     ;received..
  3310.  
  3311.     WAIT
  3312.     RECEIVE "What next? (U)pload, (D)ownload, (L)istings, (G)oodbye?"
  3313.  
  3314.     ;Say goodbye..
  3315.  
  3316.     SEND "G#"
  3317.  
  3318.     ;...and the script file ends here...
  3319.  
  3320.     HOW TO WRITE SCRIPT FILES
  3321.     -------------------------
  3322.  
  3323.     Assuming you don't want to use COSWORTH's ability to learn script
  3324.     files for you, you can always write your own using a text editor, as
  3325.     mentioned previously.
  3326.  
  3327.     In order to be able to write your own script files, though, you must
  3328.     be at least partly aware of how it is that COSWORTH deals with script
  3329.     files and acts on the prompts you include in them.
  3330.  
  3331.     The only command to note in this respect is the RECEIVE command. You
  3332.     will not be able (at least, not all the time) to use RECEIVE prompts
  3333.     if they are a considerable 'distance' up the screen from the cursor.
  3334.     COSWORTH keeps a constant check on the characters you are receiving
  3335.     and maintains a list of the last 255 of them. If you ask COSWORTH to
  3336.     RECEIVE a prompt (or part of a prompt) that is more than appeared on
  3337.     the screen more than 255 characters ago, then COSWORTH will never find
  3338.     it and the chances are that your script file will fail.
  3339.  
  3340.     In general, the best prompts to choose for this purpose are found in
  3341.     the last few lines received. For example, if you wish a script file to
  3342.     automatically enter a menu choice for you from a menu that fills the
  3343.     screen and displays the prompt 'What is your choice? :', then this
  3344.     prompt - being the latest received by you - would be the most sensible
  3345.     to choose.
  3346.  
  3347.     Once COSWORTH has recognised that it has indeed RECEIVEd the string
  3348.     you are asking for, then its blanks out the list of characters it is
  3349.     monitoring, in order that anything you receive after that will not be
  3350.     interfered with by past prompts.
  3351.  
  3352.  
  3353.     'SMART' SCRIPT FILES
  3354.     --------------------
  3355.  
  3356.     'What on Earth is a 'smart' script file?', I hear you ask. And well
  3357.     you may. This is a feature which is (we think!) unique to COSWORTH and
  3358.     which might save a bit of time. Smart scripts are only used should a
  3359.     script file fail or start to fail. Huh? I'll try and explain...
  3360.  
  3361.  
  3362.  
  3363.  
  3364.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 51
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.     Picture the scene. You have set up a script file for your local BBS
  3374.     which will log you on, pick up your mail, upload your replies, grab
  3375.     the latest files listings and then log off. You've tested it and
  3376.     watched it doing its stuff and it works just fine. So you set up Auto
  3377.     Dialler to contact the BBS using your precious script file, whilst you
  3378.     are in your bed, dreaming of the day you'll own a better modem.
  3379.  
  3380.     Unknown to you, though, the BBS Sysop has stuck a temporary
  3381.     message on the board advising everyone of something - his holidays,
  3382.     Merry Christmas, the dog's not well or whatever. Say the message looks
  3383.     like this;
  3384.  
  3385.                  ╔═══════════════════════════════════════╗
  3386.                  ║                                       ║
  3387.                  ║       Would all users fill in the     ║
  3388.                  ║ questionnaire in mail area #2 please? ║
  3389.                  ║                                       ║
  3390.                  ║                Thanks.                ║
  3391.                  ║                                       ║
  3392.                  ║           Bob - BBS Sysop             ║
  3393.                  ║                                       ║
  3394.                  ╚═══════════════════════════════════════╝
  3395.  
  3396.                   Press [ENTER] to continue...
  3397.  
  3398.  
  3399.     What would happen? Well, your script file won't know about the 'Press
  3400.     [ENTER] to continue...' prompt sitting on your screen and will
  3401.     probably be sitting there, merrily waiting for a prompt which will
  3402.     never appear because it doesn't see what it is expecting.
  3403.  
  3404.     The final result will be that the script file will either time out
  3405.     (because it hasn't received the right prompt in time), if using the
  3406.     Auto Dialler then the maximum length of the Auto Dialler connection
  3407.     will be reached (eventually) or COSWORTH will time out because it
  3408.     doesn't receive any data within the Auto Dialler Time Out period (as
  3409.     specified in the configuration menu) or else - if it's using smart
  3410.     enough software - the BBS itself will time you out.
  3411.  
  3412.     Either way, it means no carrier, no mail and no file listings. You get
  3413.     up the next morning to find that the connection has failed and mutter
  3414.     threats as you log on at a peak time to do the whole thing manually.
  3415.  
  3416.     Well, that WOULD be the case, except...it might not be. What happens
  3417.     is this;
  3418.  
  3419.     COSWORTH knows that your script file is about to time out. What it
  3420.     does, just on the point where the script is about to time out, is lift
  3421.     the prompt from the screen and examine it, making a best guess as to
  3422.     what is required by the BBS, then sends that guess (with a return
  3423.     character) up the line in an attempt to get things moving again.
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 52
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.     If COSWORTH cannot make head nor tail of the prompt then it tries a
  3440.     return character by default just to see what would happen. If that
  3441.     fails then the script will time out as normal and the connection will
  3442.     be broken.
  3443.  
  3444.     How does it do this? The answer is simple - it follows logical tests
  3445.     to try and work out what the BBS software wants. These tests check to
  3446.     see whether the prompt contains 'Y/N', 'Press RETURN', 'MORE?' or
  3447.     numerous combinations thereof and returns a 'best guess' character.
  3448.  
  3449.     Smart scripts will only be used ONCE. If the one attempt fails to do
  3450.     anything then the script is allowed to time out.
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.     COSWORTH COMMUNICATIONS SOFTWARE - Script Files                 page 53
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.     KEYSTROKE MACROS WITHIN COSWORTH
  3506.     --------------------------------
  3507.  
  3508.     Macros are a handy way of saving you some time. With a macro, you can
  3509.     associate a line of text (or 'string' as it is more commonly known)
  3510.     with a particular keystroke. When that keystroke has been made, the
  3511.     line of text you have previously associated with that key will be sent
  3512.     to your modem.
  3513.  
  3514.     This feature only works when you are either in terminal mode or when
  3515.     you have connected to a remote system using the dialling directory.
  3516.  
  3517.     EDITING MACROS
  3518.     --------------
  3519.  
  3520.     In order to set up your macros, press F5 from the main menu. The macro
  3521.     string editor will appear, which looks like this;
  3522.  
  3523. ┌─────────────────────────────┤ MACRO STRINGS ├──────────────────────────────┐
  3524. │ ALT-F1   JOE BLOGGS#...................................................... │
  3525. │ ALT-F2   *PASSWORD#....................................................... │
  3526. │ ALT-F3   ................................................................. │
  3527. │ ALT-F4   ................................................................. │
  3528. │ ALT-F5   ................................................................. │
  3529. │ ALT-F6   ................................................................. │
  3530. │ ALT-F7   ................................................................. │
  3531. │ ALT-F8   ................................................................. │
  3532. │ ALT-F9   ................................................................. │
  3533. │ ALT-F10  ................................................................. │
  3534. │ CTRL-F1  ................................................................. │
  3535. │ CTRL-F2  ................................................................. │
  3536. │ CTRL-F3  ................................................................. │
  3537. │ CTRL-F4  ................................................................. │
  3538. │ CTRL-F5  ................................................................. │
  3539. │ CTRL-F6  ................................................................. │
  3540. │ CTRL-F7  ................................................................. │
  3541. │ CTRL-F8  ................................................................. │
  3542. │ CTRL-F9  ................................................................. │
  3543. │ CTRL-F10 ................................................................. │
  3544. └─┤ # = RETURN CHAR, ~ = HALF SEC PAUSE, F1 HELP, F10 ACCEPTS, ESC ABORTS ├──┘
  3545.  
  3546.     All the possible 20 macro keystrokes are listed together with whatever
  3547.     text (if any) is associated with them. The above example shows what
  3548.     macros are created by the COSWORTH installation program. (Although
  3549.     obviously your name will appear for ALT-F1 and not that of the
  3550.     ubiquitous Mr Bloggs.)
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.     COSWORTH COMMUNICATIONS SOFTWARE - Keystroke Macros             page 54
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.     On starting the macro editor the currently highlighted field will be
  3572.     that associated with ALT-F1. You can move to the field you wish by
  3573.     pressing the up and down arrow keys. When you reach the field you wish
  3574.     to edit, enter whatever text you wish, up to a limit of 200
  3575.     characters. Once you are happy with whatever text you have entered,
  3576.     press return to store that text in the field. Once you have edited all
  3577.     the macros you wish, press F10 to quit the macro editor and
  3578.     automatically save the macros to the disk file COSWORTH.MAC. On the
  3579.     other hand, if you do not wish to keep the macros you have just
  3580.     edited, pressing escape will exit you from the editor with
  3581.     confirmation.
  3582.  
  3583.     When you are entering the text of your macros, you may use the
  3584.     following variables which will be expanded to their full meaning on
  3585.     being sent to your modem;
  3586.  
  3587.       *NAME      This is the full name as set up in the User's Name entry
  3588.                  in the Program Settings menu.
  3589.  
  3590.       *FIRST     This will return the Christian name extracted from the
  3591.                  User's Name entry in the Program Settings menu. Note that
  3592.                  if your name uses more than three 'words' (like 'Billie
  3593.                  Jean King') then *FIRST will only return the first word
  3594.                  extracted from the name. This is only to avoid an
  3595.                  ambiguity.
  3596.  
  3597.       *LAST      This will return the surname extracted from the User's
  3598.                  Name entry in the Program Settings menu. Note that if
  3599.                  your name uses more than three 'words' (like 'Rip Van
  3600.                  Winkle') then *LAST will only return the last word
  3601.                  extracted from the name. This is only to avoid any
  3602.                  ambiguity.
  3603.  
  3604.       *PASSWORD  This will be expanded to give the password you have
  3605.                  allocated to the remote system in the dialling directory.
  3606.  
  3607.       # (hash)   This is interpreted as a 'return' character.
  3608.  
  3609.       ~ (tilde)  This will cause the macro to pause for half a second at
  3610.                  that particular point.
  3611.  
  3612.       ^ (caret)  To insert control characters into your macro strings, use
  3613.                  the caret notation. For example, ^M is interpreted as
  3614.                  CTRL-M, which would insert a return character into your
  3615.                  macro. To insert a caret into your strings use two carets
  3616.                  together, as in ^^. Some of the more familiar control
  3617.                  characters are
  3618.  
  3619.                              ^M        CR        Carriage Return
  3620.                              ^J        LF        Line Feed
  3621.                              ^L        FF        Form Feed
  3622.                              ^[        ESC       Escape
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.     COSWORTH COMMUNICATIONS SOFTWARE - Keystroke Macros             page 55
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.                  NOTE: If you are using XON/XOFF handshaking then take
  3638.                  care not to include either ^Q (XON) or ^S (XOFF)
  3639.                  characters in your macro strings as they will probably
  3640.                  disturb transmission when connected to another system.
  3641.  
  3642.     The use of the tilde (~) character should be explained here. This can
  3643.     be useful for a number of things, mainly for sending often used
  3644.     strings to your modem from within terminal mode. For example, imagine
  3645.     you have the following macros set up for a keystroke;
  3646.  
  3647.                               'ATZ#~~~~ATS0=2#'
  3648.  
  3649.     What happens here is that when the keystroke is made, the macro is
  3650.     sent to the modem as usual. However, on reaching each tilde, the macro
  3651.     pauses for half a second. The reason this may be useful is to allow
  3652.     your modem two seconds (represented by the four tildes) to react to
  3653.     the initial 'ATZ' and then to send the following 'ATS0=2'. It may
  3654.     require a bit of experimenting to get the right delays between the
  3655.     commands and not have them 'overlap'.
  3656.  
  3657.     Another possible use for macros might be to hold your name, address
  3658.     and telephone number. This might allow you to complete questionnaires
  3659.     often found on bulletin boards for new users!
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.     COSWORTH COMMUNICATIONS SOFTWARE - Keystroke Macros             page 56
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.     AUTO DIALLER
  3704.     ------------
  3705.  
  3706.     COSWORTH has the facility to allow you to specify up to five entries
  3707.     from any single dialling directory and connect to them on a timed
  3708.     basis. This facility is enabled through easy to use menus to create
  3709.     the Auto Dialler control files and is completely automated.
  3710.  
  3711.     Before you start getting nervous, COSWORTH also has a number of built
  3712.     in safety checks to ensure that, should anything go wrong, your modem
  3713.     will not be left on line for any longer than you specify.
  3714.  
  3715.     Using the Auto Dialler command itself can either be made through
  3716.     COSWORTH's own menu system, or through a command line switch. The
  3717.     former method allows you to set up an Auto Dialler session that can be
  3718.     set as far ahead as (almost) twenty four hours. The latter method may
  3719.     be used in conjunction with other mechanisms (such as a software timer
  3720.     or a timed power supply to your computer) to allow you to set up Auto
  3721.     Dialler sessions for whenever you wish.
  3722.  
  3723.     An Auto Dialler session can only be run on dialling directory entries
  3724.     that have an associated script file whose commands will take the
  3725.     session from the beginning right through to the end. If a script file
  3726.     terminates prematurely (for example, by forgetting to issue the
  3727.     command to log off) then the script file will close as normal but the
  3728.     Auto Dialler session will continue! It is most important to realise
  3729.     that it is the users sole responsibility to ensure that scripts are
  3730.     both complete and have been fully tested prior to their being used on
  3731.     an Auto Dialler session.
  3732.  
  3733.     In saying all the above, it must be borne in mind that COSWORTH has
  3734.     been designed to cope with any unexpected problems whilst an
  3735.     unattended Auto Dialler session is in progress. These safeguards are
  3736.     as follows;
  3737.  
  3738.     - If a script file times out (ie, is waiting for a prompt that never
  3739.       arrives within the script file time out period) then the Auto
  3740.       Dialler session is aborted.
  3741.  
  3742.     - If you try to Auto Dial to a system which has no script file
  3743.       associated with it then Auto Dialler will refuse to allow you to
  3744.       include this entry in a control file during the set up process.
  3745.  
  3746.     - If your modem does not receive any incoming data within the Auto
  3747.       Dialler Time Out period specified in the configuration, then the
  3748.       connection will be aborted since it will be assumed the remote
  3749.       system has 'hung'.
  3750.  
  3751.     - The MINIMUM SPEED directive in the script language ensures that a
  3752.       minimum baud rate is required before the connection is made, thereby
  3753.       ensuring that you won't be on line any longer than you have to be
  3754.       because of a slow data transfer rate.
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 57
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.     - As part of the Auto Dialler control file set up, you specify the
  3770.       maximum length of time the modem will stay on line for each
  3771.       connection.
  3772.  
  3773.     As a final (possible) precaution, it must also be remembered that most
  3774.     modern host systems will time YOU out if you don't send any data back
  3775.     to it within a specified time period.
  3776.  
  3777.     When an Auto Dialler session is running, all COSWORTH's actions are
  3778.     controlled via the commands in the script language. That way, no menus
  3779.     or selection boxes occur on the screen. All your capture files,
  3780.     uploading, downloading and deleting are controlled by your scripts.
  3781.  
  3782.     Auto Dialler sessions also implement the 'smart scripts' ability to
  3783.     (possibly) get out of situations where your script file has gone
  3784.     astray. In short, this is the completely automatic ability for
  3785.     COSWORTH to tell where a script is going wrong and to correct it by
  3786.     sending the appropriate keystrokes automatically! See the section of
  3787.     this manual on script files for more details about 'smart scripts'.
  3788.  
  3789.     Auto Dialler has many uses - some we probably haven't yet envisaged
  3790.     ourselves - but the main advantage in it the ability to log onto busy
  3791.     systems during the middle of the night when traffic is light, without
  3792.     having to stay awake for it!
  3793.  
  3794.  
  3795.     SETTING UP AN AUTO DIALLER CONTROL FILE
  3796.     ---------------------------------------
  3797.  
  3798.     This couldn't be made much easier if we tried. From the main menu,
  3799.     press F4 or scroll the highlight bar down to the 'Auto Dialling
  3800.     Facility' title to enter the Auto Dialler function. Once you have
  3801.     done so, you will see a menu something like this;
  3802.  
  3803.             ┌───────────────────────────────────────────────────┐
  3804.             │                 AUTO DIALLER MENU                 │
  3805.             │           Select Choice or ESC to Quit            │
  3806.             │                                                   │
  3807.             │     >F1  Set Up Auto Dialler Control File         │
  3808.             │      F2  Auto Dial Using COSWORTH Directory       │
  3809.             │      F3  Auto Dial Using STR_BEAN Directory       │
  3810.             │      F4  Auto Dial Using EUROPE Directory         │
  3811.             │      F5  Auto Dial Using FIDONET Directory        │
  3812.             │      F6  Auto Dial Using SUPPORT Directory        │
  3813.             │      F7  EXIT                                     │
  3814.             │                                                   │
  3815.             └───────────────────────────────────────────────────┘
  3816.  
  3817.     If you haven't already set up any Auto Dialler control files then you
  3818.     will only see the first and last lines. The others in the middle are
  3819.     for starting up an Auto Dialler session. For the time being, let's
  3820.     concentrate on getting the control file created.
  3821.  
  3822.     Pressing F1 for the Set Up routine brings up a further scrolling menu
  3823.     of all the dialling directories you have on your disk, thus;
  3824.  
  3825.  
  3826.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 58
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.    ┌─────────────────────────────────────────────────────────────────────┐
  3836.    │    In order to create an Auto Dialler control file, COSWORTH must   │
  3837.    │    know from which dialling directory your entries are to be made.  │
  3838.    │    Please select the directory from which the control file is to be │
  3839.    │    constructed.                                                     │
  3840.    └─────────────────────────────────────────────────────────────────────┘
  3841.  
  3842.            ┌─C:\COSWORTH\*.PHN───────────────────────────────────┐
  3843.            │>COSWORTH.PHN    1692    Apr 19,1992     1:03a     A<│
  3844.            │ EUROPE.PHN        94    Apr 08,1992     5:57a     A │
  3845.            │ LONGDIST.PHN     658    Apr 16,1992     1:08a     A │
  3846.            │ FIDONET.PHN      188    Apr 08,1992     5:57a     A │
  3847.            │ SUPPORT.PHN       94    Apr 18,1992     7:48a     A │
  3848.            │ STR_BEAN.PHN     376    Apr 18,1992     6:47p     A │
  3849.            │                                                     │
  3850.            │                                                     │
  3851.            └─────────────────────────────────────────────────────┘
  3852.  
  3853.     Move the scrolling highlight bar in the directory list window and
  3854.     select the dialling directory from which you wish the Auto Dialler
  3855.     control file to be made. Now, one of two things will happen. If you
  3856.     already have a control file for the dialling directory you will be
  3857.     taken straight into editing it. However if you don't then you will be
  3858.     invited to select which systems you wish to contact. We will assume
  3859.     the latter situation by selecting LONGDIST.PHN from the directory. (If
  3860.     a control file for this directory had existed then it would have
  3861.     appeared in the main Auto Dialler menu, after all.)
  3862.  
  3863.     If you choose a directory with no associated Auto Dialler control
  3864.     file then a similar menu to the following one will appear;
  3865.  
  3866.       ┌────────────────────────────────────────────────────────────────┐
  3867.       │   MICROSOFT USA                 │ M0101 206 637 9009           │
  3868.       │   APOGEE BBS                    │ M0101 508 3659668            │
  3869.       │   WITCHITA STATE UNIVERSITY     │ M0101-316689-3779            │
  3870.       │   CREATIVE LABS (SOUNDBLASTER)  │ M0101 408 982-9226           │
  3871.       │   UNIVERSITY OF ARIZONA         │ M0101 602 621 2283           v
  3872.       └────────────────────────────────────────────────────────────────┘
  3873.  
  3874.      ╔═════════════════════════════════════════════════════════════════╗
  3875.      ║ You have selected a directory for which no auto dialler control ║
  3876.      ║  file exists. Using the space bar, select up to five entries to ║
  3877.      ║      be included in the control file. Press return when all     ║
  3878.      ║  selections are complete or press the escape key to abort this  ║
  3879.      ║                             process.                            ║
  3880.      ╚═════════════════════════════════════════════════════════════════╝
  3881.  
  3882.     As the directions in the box state, tag up to five entries you wish to
  3883.     be Auto Dialled from the scrolling list in the upper window. The small
  3884.     arrow in the right hand side of this window indicates that there are
  3885.     more entries below the last one you can see on the screen. If you tag
  3886.     more than five entries then (a) only the first five will be used and
  3887.     (b) you clearly have some advanced form of learning difficulty.
  3888.  
  3889.  
  3890.  
  3891.  
  3892.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 59
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.     Once you have tagged your entries, press return and you will be taken
  3902.     into the Auto Dialer control file editor. You will see something like
  3903.     this;
  3904.  
  3905.                        AUTO DIALLER CONTROL FILE SET UP
  3906.  
  3907.           Remote System                    Start   Stop    Max.
  3908.       ┌────────────────────────────────────────────────────────────────┐
  3909.       │  >MICROSOFT USA                    00:00   00:00   00:00<      │
  3910.       │   APOGEE BBS                       00:00   00:00   00:00       │
  3911.       │   WITCHITA STATE UNIVERSITY        00:00   00:00   00:00       │
  3912.       │   CREATIVE LABS (SOUNDBLASTER)     00:00   00:00   00:00       │
  3913.       │   UNIVERSITY OF ARIZONA            00:00   00:00   00:00       │
  3914.       └────────────────────────────────────────────────────────────────┘
  3915.           Select which entry you wish to edit. DEL deletes an entry,
  3916.                     RETURN selects an entry and ESC quits.
  3917.  
  3918.     Move the scroll bar down to the first entry you wish to edit and press
  3919.     return. The edit window will pop up in the lower half of the screen
  3920.     like this;
  3921.  
  3922.  
  3923.        ┌───────────────┤ EDIT ENTRY FOR MICROSOFT USA ├───────────────┐
  3924.        │                                                              │
  3925.        │                                        HR MIN                │
  3926.        │        TIME TO START DIALLING          00:00                 │
  3927.        │        TIME TO FINISH DIALLING         00:00                 │
  3928.        │        DURATION OF THIS CALL           00:00                 │
  3929.        │                                                              │
  3930.        └─────────────────┤ CURRENT TIME IS 02:41:56 ├─────────────────┘
  3931.  
  3932.                    Input start time hours (24 hour format)
  3933.                      F10 to accept entries, ESC to abort
  3934.  
  3935.     You will see six fields opposite the three titles on the screen. Into
  3936.     these fields enter the following information;
  3937.  
  3938.     Top left field     - The hour at which the Auto Dialler will start
  3939.                          dialling this system. (24 hour format)
  3940.     Top right field    - The minute at which the Auto Dialler will start
  3941.                          dialling this system.
  3942.     Centre left field  - The hour at which the Auto Dialler will stop
  3943.                          dialling this system if it couldn't get through.
  3944.                          (24 hour format)
  3945.     Centre right field - The minute at which the Auto Dialler will
  3946.                          stop dialling this system if it couldn't get
  3947.                          through.
  3948.     Bottom left Field  - The number of hours of the maximum length of the
  3949.                          call. (24 hour format)
  3950.     Bottom right Field - The number of minutes of the maximum length of
  3951.                          the call.
  3952.  
  3953.     If you specify a maximum length of a call as being zero then COSWORTH
  3954.     will revert to using its default call length of five minutes.
  3955.  
  3956.  
  3957.  
  3958.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 60
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.     So, for example, by filling in the fields with these numbers...
  3968.  
  3969.        ┌───────────────┤ EDIT ENTRY FOR MICROSOFT USA ├───────────────┐
  3970.        │                                                              │
  3971.        │                                        HR MIN                │
  3972.        │        TIME TO START DIALLING          03:45                 │
  3973.        │        TIME TO FINISH DIALLING         04:00                 │
  3974.        │        DURATION OF THIS CALL           ..:15                 │
  3975.        │                                                              │
  3976.        └─────────────────┤ CURRENT TIME IS 02:41:56 ├─────────────────┘
  3977.  
  3978.     ...you are saying 'start dialling for Microsoft BBS at 3:45 this
  3979.     morning and keep trying to get through until 4:00. If you get through
  3980.     then make sure this call lasts no longer than 15 minutes maximum.'
  3981.  
  3982.     Once you are happy with your times then press F10 and the entry in the
  3983.     upper window will be updated to reflect the times you have just input,
  3984.     thus;
  3985.  
  3986.           Remote System                    Start   Stop    Max.
  3987.       ┌────────────────────────────────────────────────────────────────┐
  3988.       │  >MICROSOFT USA                    03:45   04:00   00:15<      │
  3989.       │   APOGEE BBS                       00:00   00:00   00:00       │
  3990.       │   WITCHITA STATE UNIVERSITY        00:00   00:00   00:00       │
  3991.       │   CREATIVE LABS (SOUNDBLASTER)     00:00   00:00   00:00       │
  3992.       │   UNIVERSITY OF ARIZONA            00:00   00:00   00:00       │
  3993.       └────────────────────────────────────────────────────────────────┘
  3994.  
  3995.     Now carry on and edit the times for all your entries. If you decide
  3996.     that you don't want an entry included in the Auto Dialler session then
  3997.     simply highlight it in the top menu and press DEL. You can them remove
  3998.     that entry from the Auto Dialler Control file altogether and its name
  3999.     will be replaced in the top menu with the words '<BLANK ENTRY>'. If
  4000.     you then wish to place another system into this blank space then
  4001.     simply move down to the blank entry and press return on it. The list
  4002.     of systems will appear in the lower half of the screen from which you
  4003.     can select the entry you want. to include. Note that (for obvious
  4004.     reasons) you cannot tag multiple files here since you are only after
  4005.     one name and not five!
  4006.  
  4007.     Don't worry if the entries are not ordered chronologically. COSWORTH
  4008.     sorts the list before saving it. Don't even worry if the times overlap
  4009.     slightly. COSWORTH will only start dialling on or slightly after the
  4010.     specified times, adjusting the other times accordingly to suit.
  4011.  
  4012.     Once you have all the times as you wish, press escape and you will be
  4013.     asked if you want to save the entries to a control file. If you press
  4014.     'N' then the process will be aborted. If you press 'Y' then the Auto
  4015.     Dialler control file will be saved out to disk under the name
  4016.     DIRNAME.AUT, where DIRNAME is the name of the dialling directory used.
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 61
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.     When you go back to the main Auto Dialler menu you will find that your
  4034.     new Auto Dialler control file is now in the menu, like this;
  4035.  
  4036.             ┌───────────────────────────────────────────────────┐
  4037.             │                 AUTO DIALLER MENU                 │
  4038.             │           Select Choice or ESC to Quit            │
  4039.             │                                                   │
  4040.             │     >F1  Set Up Auto Dialler Control File         │
  4041.             │      F2  Auto Dial Using COSWORTH Directory       │
  4042.             │      F3  Auto Dial Using STR_BEAN Directory       │
  4043.             │      F4  Auto Dial Using EUROPE Directory         │
  4044.             │      F5  Auto Dial Using FIDONET Directory        │
  4045.             │      F6  Auto Dial Using SUPPORT Directory        │
  4046.             │      F7  Auto Dial Using LONGDIST Directory       │
  4047.             │      F8  EXIT                                     │
  4048.             │                                                   │
  4049.             └───────────────────────────────────────────────────┘
  4050.  
  4051.     The menu will display up to the first twelve Auto Dialler control
  4052.     files it finds on the disk.
  4053.  
  4054.  
  4055.     STARTING AN AUTO DIALLER SESSION
  4056.     --------------------------------
  4057.  
  4058.     To start the Auto Dialler session you can do one of two things; you
  4059.     can either select the control file to be used from the above menu, or
  4060.     you can cause COSWORTH to start straight up into an Auto Dialler
  4061.     session by starting it up with the command line switch
  4062.  
  4063.                          COSWORTH AUTO=Autofile[.AUT]
  4064.  
  4065.     where 'Autofile' is replaced by the name of the control file you wish
  4066.     to use. The .AUT extension is not required but can be passed as
  4067.     appropriate.
  4068.  
  4069.     Whichever method you choose, the Auto Dialler session will commence.
  4070.  
  4071.     COSWORTH will first attempt to detect whether or not you have a live
  4072.     and working modem attached to your serial port. If you don't then an
  4073.     error (error #10, to be exact) will flash on the screen and you will
  4074.     be sent back to the dialling directory. If you DO have a working modem
  4075.     on the serial port in question (and you have specified the correct
  4076.     port, of course!) and this error occurs then try restarting COSWORTH
  4077.     with the /NOCHECKING command line switch. Auto checking like this does
  4078.     not work with all modems. See the errors section of this manual for
  4079.     more advice on this situation.
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 62
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.     If the modem detection did not report any errors you then will see a
  4100.     moving box on the screen containing details of the next connection to
  4101.     be made, something like this;
  4102.  
  4103.          ┌─────────────────────────────────────────────────────────┐
  4104.          │               THIS COMPUTER IS NOT IDLE!                │
  4105.          │  IT IS IN COSWORTH AUTO DIAL MODE AND WILL CONNECT TO   │
  4106.          │                      MICROSOFT USA                      │
  4107.          │                        AT 03:45                         │
  4108.          │                The current time is 02:42                │
  4109.          │  PRESS ESC TO HALT, SPACE TO SKIP QUEUE TO NEXT ENTRY   │
  4110.          └─────────────────────────────────────────────────────────┘
  4111.  
  4112.     As the warning box says, if you press escape then you will abandon the
  4113.     entire Auto Dialler session. If, however, you press the space bar then
  4114.     you will only abort the current connection attempt. The Auto Dialler
  4115.     will then move onto the next (chronological) entry to be contacted.
  4116.  
  4117.     When any of the systems are eventually dialled, Auto Dialler will
  4118.     persist in getting through until the either it has succeeded or else
  4119.     the 'stop time' (as defined in the centre fields of the edit box) has
  4120.     been reached. If the latter then the Auto Dialler will move onto the
  4121.     next entry, if any. If the former, then the connection is made and the
  4122.     script file will assume control of the session.
  4123.  
  4124.     Bear in mind that during any connection you may intervene and press
  4125.     ALT-K to kill the current auto dialler session FOR THAT CONNECTION
  4126.     ONLY. Other further connection attempts will be made as normal through
  4127.     the Auto Dialler. Note that once the session has been killed in this
  4128.     manner, the script file running will not be terminated and will
  4129.     continue until aborted with the ALT-A keystroke. The reason for the
  4130.     ALT-K keystroke is this; if it is obvious that a script file is going
  4131.     awry or if you simply want to interrupt the script then aborting it
  4132.     with ALT-A will, during an Auto Dialler session, cause COSWORTH to
  4133.     think that the script terminated prematurely and will drop carrier, as
  4134.     part of the inbuilt protection against Auto Dialler sessions leaving
  4135.     you on line for lengthy periods. By pressing ALT-K, this problem can
  4136.     be circumvented by simply telling COSWORTH that the current connection
  4137.     must not be considered as an Auto Dialler connection. Please also be
  4138.     aware that 'smart scripts' will not operate during a 'killed' session.
  4139.  
  4140.     Once all connections have been made or attempted, a report will be
  4141.     written to the screen stating just what happened during that session.
  4142.     The report will look something like this;
  4143.  
  4144.     ╒═════════════════╣ RESULTS OF AUTO DIALLER SESSION ╠═════════════════╕
  4145.     │   MICROSOFT USA - Connected OK, directory updated                   │
  4146.     │   APOGEE BBS - Connected OK, directory not updated                  │
  4147.     │   WITCHITA STATE UNIVERSITY - Connected OK but script timed out     │
  4148.     │   CREATIVE LABS (SOUNDBLASTER) - Did not connect                    │
  4149.     │   UNIVERSITY OF ARIZONA - Did not connect, no script file           │
  4150.     ╘═════════════════════════════════════════════════════════════════════╛
  4151.  
  4152.  
  4153.  
  4154.  
  4155.  
  4156.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 63
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.     The results have the following meanings;
  4166.  
  4167.     'No attempt made to connect' - You either pressed the escape key or
  4168.                    the space bar while the Auto Dialler was waiting to
  4169.                    dial this number, causing the number to be skipped.
  4170.  
  4171.     'Connected OK, directory updated' - The session was OK and COSWORTH
  4172.                    managed to open the associated dialling directory and
  4173.                    update the number of calls made to the system and the
  4174.                    length of time spent on line.
  4175.  
  4176.     'Connected OK, directory not updated' - The session was OK but
  4177.                    COSWORTH either could not find the associated dialling
  4178.                    directory (you might have deleted it) or else it found
  4179.                    the directory but could not locate an entry for the
  4180.                    system in it. (It might have been deleted from the
  4181.                    directory)
  4182.  
  4183.     'Connected OK but script timed out' - The connection was made OK but
  4184.                    the script file timed out when you were on line In
  4185.                    addition, the 'smart script' feature could not identify
  4186.                    how to fix the position with the script when it was
  4187.                    timing out. The session was most likely left
  4188.                    incomplete. Review the script file and make any changes
  4189.                    to it that will prevent time out.
  4190.  
  4191.     'Did not connect' - The connection could not be made. Either the line
  4192.                    was constantly engaged, the other modem would not
  4193.                    answer or the number has been disconnected. Check you
  4194.                    were dialling the right number!
  4195.  
  4196.     'Did not connect, no script file' - COSWORTH didn't even attempt to
  4197.                    Auto Dial this number since it found no script file
  4198.                    associated with the dialling directory extract stored
  4199.                    in the Auto Dialler control file. To remedy this,
  4200.                    either learn or write the appropriate script file,
  4201.                    associate it with the system in the dialling directory,
  4202.                    test it and then edit the Auto Dialler control file.
  4203.                    You must then delete the entry for this system and then
  4204.                    reinstall it in the <BLANK ENTRY>. The reason for this
  4205.                    is that the Auto Dialler editor stores the entire
  4206.                    portion of the dialling directory when it is made, and
  4207.                    any updates made to the dialling directory will not be
  4208.                    made to the associated Auto Dialler control file.
  4209.  
  4210.     'Connected OK but max. time exceeded' - The connection was made OK but
  4211.                    the maximum connection time allowed was exceeded. It
  4212.                    may be that you did not allocate enough time for the
  4213.                    call. Although unlikely, it may also be that you have a
  4214.                    WAIT command (with no passed arguments) awaiting a
  4215.                    string from the remote system and Auto Dialler and
  4216.                    Script File time outs (set in the Program Settings
  4217.                    section) set to longer than the allowed duration of the
  4218.                    call.
  4219.  
  4220.  
  4221.  
  4222.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 64
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231.     If you started from the DOS command line then COSWORTH will halt at
  4232.     this point. If, however, the Auto Dialler session was invoked from the
  4233.     command line then you are invited to press any key to clear the report
  4234.     from the screen and return to the menu system.
  4235.  
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.     COSWORTH COMMUNICATIONS SOFTWARE - Auto Dialler                 page 65
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.     TERMINAL MODE
  4298.     -------------
  4299.  
  4300.     Pressing F3 from the main menu will take you into COSWORTH's terminal
  4301.     mode. This gives you the ability to send commands straight to your
  4302.     modem by typing them onto the screen and pressing return. This may be
  4303.     useful in running diagnostic checks on your modem or for temporarily
  4304.     setting COSWORTH up to act as a host system by putting your modem into
  4305.     auto answer mode.
  4306.  
  4307.     When starting up terminal mode, COSWORTH will first attempt to detect
  4308.     whether or not you have a live and working modem attached to your
  4309.     serial port. If you don't then an error (error #10, to be exact) will
  4310.     flash on the screen and you will be sent back to the main menu. If you
  4311.     DO have a working modem on the serial port in question (and you have
  4312.     specified the correct port, of course!) and this error occurs then try
  4313.     restarting COSWORTH with the /NOCHECKING command line switch. Auto
  4314.     checking like this does not work with all modems. See the errors
  4315.     section of this manual for more advice on this situation.
  4316.  
  4317.     The next thing to happen is that COSWORTH will check for the presence
  4318.     of a resident Fossil driver. If it finds that a Fossil driver has been
  4319.     loaded then an error stating that it is initialising the port, but
  4320.     that it has detected the driver and (hence) the port may not be
  4321.     initialised as you expect. Occasionally, a resident fossil will hold
  4322.     the baud rate of the port to that which it has been set and will not
  4323.     allow further initialisation of the port to proceed. However, this
  4324.     error will only flag the presence of the Fossil driver - it will not
  4325.     prevent the port initialisation from proceeding.
  4326.  
  4327.     After this, COSWORTH will attempt to detect and disable FIFO buffering
  4328.     found in 16550A UART chips, on the selected serial port. If the
  4329.     buffering is left active then COSWORTH will not be able to initialise
  4330.     the port at all. After this, the port will be initialised using the
  4331.     required baud, parity, stop and data bits, following which FIFO
  4332.     buffering will be re-enabled.
  4333.  
  4334.     Assuming that no problems arise with the modem detection, COSWORTH
  4335.     then initialises your serial port with the default settings you have
  4336.     specified in the Directory Defaults section of the configuration menu.
  4337.     Once the serial port has been initialised then the screen is cleared
  4338.     and the cursor is positioned in the top left of the screen. From now
  4339.     on, any characters you type will be cumulatively added together until
  4340.     you press return, at which point all the characters will be set to the
  4341.     modem, together with a return character.
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.     COSWORTH COMMUNICATIONS SOFTWARE - Terminal Mode                page 66
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.     There are several special keystrokes which you can use in terminal
  4364.     mode when NOT on line (ie connected to another modem). These are;
  4365.  
  4366.     ALT-C   Change the capture file status. If a capture file is not
  4367.             running then you will be asked if you want to start
  4368.             one. If you reply that you do then you will be prompted for the
  4369.             name of the capture file to create. If that file already
  4370.             exists then it will be appended to, if it doesn't exist then it
  4371.             will be created.This file name defaults to COSWORTH.CAP. If a
  4372.             capture file is running then you will be asked whether you want
  4373.             to stop it or to suspend it temporarily. If a capture file has
  4374.             been suspended then you will be asked whether you want to
  4375.             reactivate it or not. In any event, the keys to press in
  4376.             response are shown in brackets in the information box that
  4377.             appears on pressing this keystroke.
  4378.  
  4379.     ALT-D   Shell to DOS temporarily. The screen will clear and you will
  4380.             find yourself in a DOS session. To re-enter COSWORTH, type EXIT
  4381.             <return> at the DOS prompt and you will find yourself at
  4382.             exactly the same position you were in before you shelled out.
  4383.  
  4384.     ALT-M   Modify the display type. This will pop up a small box asking
  4385.             you which of Teletype or ANSI terminal emulation you require.
  4386.             Pressing the initial letter of the display type (either T or A)
  4387.             will invoke that particular terminal emulation type.
  4388.  
  4389.     ALT-P   Toggles printer capture on or off.
  4390.  
  4391.     ALT-S   Take a snapshot of the current screen. The entire contents of
  4392.             the screen (but not the status line) will be captured and
  4393.             stored in the COSWORTH.SNP snapshot file.
  4394.  
  4395.     ALT-T   Toggles destructive backspace on and off.
  4396.  
  4397.     F1      Shows a summarised help screen.
  4398.  
  4399.     F2      Shows a summary of all the keystroke macros you have defined.
  4400.  
  4401.     F3      Recalls and sends the last string sent to your modem.
  4402.  
  4403.     F4      Sends your modem reset string (as defined in the modem strings
  4404.             section of the configuration menu) to the modem.
  4405.  
  4406.     F5      Sends your modem initialisation string (as defined in the
  4407.             modem strings section of the configuration menu) to the modem.
  4408.  
  4409.     F6      Sends your Mercury Personal Identification Number (as defined
  4410.             in the modem strings section of the configuration menu, if
  4411.             defined at all) to the modem.
  4412.  
  4413.     F7      Clears the screen.
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.     COSWORTH COMMUNICATIONS SOFTWARE - Terminal Mode                page 67
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.     When on-line within terminal mode, all these keystrokes (apart from
  4430.     those defined by F3, F4, F5, F6 and F7) are available as well as the
  4431.     following; ALT-B, ALT-E, ALT-H, ALT-L, ALT-N, ALT-R, ALT-U, ALT-X,
  4432.     ALT-=, PageUp and PageDn
  4433.  
  4434.     All these keystrokes have the same meaning as those when connected on
  4435.     line from the dialling directory. When going on line with COSWORTH,
  4436.     your connect string (if any) is shown on the screen and the status bar
  4437.     changes to that similar to that when connected from the dialling
  4438.     directory.
  4439.  
  4440.     When a connection is terminated from the terminal mode then it will be
  4441.     returned to its off line mode again. To quit from the off line
  4442.     terminal mode, press escape. You will be returned to the main menu.
  4443.  
  4444.  
  4445.     AUTO ANSWERING
  4446.     --------------
  4447.  
  4448.     Cosworth is not primarily intended to be used as a host system, but if
  4449.     necessary (and if your modem can support it) it can be set up to
  4450.     receive incoming calls. If you are using a Hayes-compatible modem,
  4451.     this is usually enabled by sending the command
  4452.  
  4453.                                ATS0=[n]<return>
  4454.  
  4455.     to your modem, where [n] is a non-zero number representing the number
  4456.     of times your modem will allow the phone to ring before picking the
  4457.     line up. If you are not using a Hayes compatible modem then you will
  4458.     have to refer to your modem manual to obtain the correct string.
  4459.  
  4460.     When an incoming call is received, COSWORTH checks to see whether the
  4461.     modem is in auto answer mode or not. If it is, and a carrier is
  4462.     obtained, the connect string is displayed on the screen with the
  4463.     connection melody. The name of the remote system on the status line
  4464.     becomes AUTO ANSWER MODE. Notice that you will have to enable local
  4465.     echo and line feeds before you can see what you are typing on the
  4466.     screen when connected, if they are not set up by default.
  4467.  
  4468.     To disconnect the link, press ALT-H to hang up the line and drop
  4469.     carrier. You will then be returned to the terminal mode off line. It
  4470.     might be a good idea to enter your modem's RESET string at this point
  4471.     to disable the auto answer facility, then press escape to return to
  4472.     the main menu.
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.     COSWORTH COMMUNICATIONS SOFTWARE - Terminal Mode                page 68
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.     ANCILLARY FILES
  4496.     ---------------
  4497.  
  4498.     COSWORTH creates numerous files as and when (or if) it requires. This
  4499.     short section deals with these files and describes their structure.
  4500.  
  4501.  
  4502.     THE LOG FILE (COSWORTH.LOG)
  4503.     ---------------------------
  4504.  
  4505.     The COSWORTH log file holds details of every connection you make. Here
  4506.     is an example extract from it;
  4507.  
  4508.     19:54:02 │ Saturday February 29, 1992
  4509.              │ AUTO DIALLER SESSION
  4510.              │ Connected To MENTAL FRANKIE'S BBS          (Using MERCURY)
  4511.              │ Baud 2400
  4512.              │ Minimum connect speed of 9600 baud not reached.
  4513.              │ Capture file for new system : FRANKIE.CAP Opened.
  4514.              │ Learning Script file : FRANKIE.SPT
  4515.              │ NOTE: Password chosen as IWANNA16550
  4516.              │ WARNING : Unexpected prompt received, at script line
  4517.              │           number 16. Smart script interpreter enabled.
  4518.              │ Extended keystrokes disabled.
  4519.              │ Extended keystrokes re-enabled.
  4520.              │ Shelled to DOS.
  4521.              │ Returned from DOS.
  4522.              │ Capture file suspended.
  4523.              │ - Download [MAILBAG.ZIP]
  4524.              │ + Upload [COSWORTH.ZIP]
  4525.              │ COSWORTH.ZIP deleted
  4526.              │ Capture file reactivated.
  4527.              │ Script file : FRANKIE.SPT closed by Cosworth.
  4528.              │ Capture file Closed by Cosworth.
  4529.     19:56:22 │ Alt H used to terminate session.
  4530.              │ Time Connected 00:02:20
  4531.  
  4532.     Obviously this is not intended to be a realistic example! There is no
  4533.     way that you could have managed to start up Auto Dialler without a
  4534.     script file, for instance, but this is only intended to give you an
  4535.     idea as to what to expect in a log file entry. Auto dialler or auto
  4536.     answer sessions are flagged as being such by heading the entry with a
  4537.     note in capital letters. The name of the remote system will then be
  4538.     shown together with the connect speed. The next line is what would
  4539.     appear in the log file should the MINIMUM SPEED directive of the
  4540.     script facility not be reached. Under normal circumstances, this would
  4541.     result in the call being terminated. Since the user has never called
  4542.     this system before, COSWORTH is offering to automatically open a
  4543.     capture file for him, which he has accepted. We then get an indication
  4544.     that a script file is being automatically learned by COSWORTH. After
  4545.     that, a (rather unlikely) note has been tacked into the log file by
  4546.     the user pressing ALT-N when on line.
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.     COSWORTH COMMUNICATIONS SOFTWARE - Ancillary Files              page 69
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.     The line starting with 'WARNING' is what will occur should the 'smart
  4562.     script' facility come into play. The offending line of the script file
  4563.     is also indicated. Note that the line mentioned contains the 'RECEIVE'
  4564.     prompt that was NOT received in time. The user then disabled all
  4565.     extended keystrokes with ALT-= and then re-enabled them with ALT-=
  4566.     again. He then shelled out to DOS and then returned, followed by him
  4567.     suspending the capture file from running.
  4568.  
  4569.     He then downloaded a mailbag and (sensible fellow) uploaded
  4570.     COSWORTH.ZIP to the system. This file matched the file masks in the
  4571.     mail files configuration so it was deleted. He then reactivated the
  4572.     capture file from its suspended state.
  4573.  
  4574.     After this, he terminated the connection causing the script and
  4575.     capture files to be closed automatically by COSWORTH. An indication as
  4576.     to how his call was terminated was given (ALT-H? Tsk, tsk, tsk...) and
  4577.     his log off time and total connection times are shown.
  4578.  
  4579.  
  4580.     THE ERROR FILE (COSWORTH.ERF)
  4581.     -----------------------------
  4582.  
  4583.     This file holds a record of all the errors that appear within
  4584.     COSWORTH. This may be useful to you since you may miss any errors
  4585.     which occur, so a permanent record of them is held.
  4586.  
  4587.     This is a simple text file of the following format;
  4588.  
  4589.               <DATE><TIME>ERROR#<NUMBER>-<ERRORMESSSAGE>
  4590.  
  4591.  
  4592.     THE CAPTURE FILE (USER-DEFINABLE NAMES)
  4593.     ---------------------------------------
  4594.  
  4595.     This contains a straight 'capture' of all text that has appeared on
  4596.     your screen between the times the capture file is invoked and either
  4597.     the time you close it or when you log off. One thing, though. If a
  4598.     system is using ANSI escape codes to draw fancy menus or logos and
  4599.     thereby move the cursor in a non-standard way (ie, not from left to
  4600.     right and from top to bottom) then there is a good chance the capture
  4601.     file will be jumbled at this point. Unavoidable, we are afraid! The
  4602.     points at which the capture file is either suspended, closed or
  4603.     appended are marked with a dashed line.
  4604.  
  4605.  
  4606.     THE SNAPSHOT FILE (COSWORTH.SNP)
  4607.     --------------------------------
  4608.  
  4609.     This is almost exactly like the capture file except that all captures
  4610.     are made at the time across the screen so even fancy ANSI screens are
  4611.     captured properly. Each snapshot is separated with a dashed line.
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.     COSWORTH COMMUNICATIONS SOFTWARE - Ancillary Files              page 70
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.     ABOUT THE DEVELOPMENT OF COSWORTH
  4628.     ---------------------------------
  4629.  
  4630.     COSWORTH was written by us because we never found a comms program that
  4631.     met all our needs. There are many on the market, but we found them
  4632.     either to cumbersome or too simplistic, hence COSWORTH.
  4633.  
  4634.     COSWORTH was written in Borland Turbo Pascal using version 6.0 of the
  4635.     compiler. It was debugged under Borland Turbo Debugger version 2.0 and
  4636.     streamlined using Borland Turbo Profiler version 1.0. Certain other
  4637.     portions of the work were written and compiled under Borland Turbo
  4638.     Assembler version 2.0.
  4639.  
  4640.     Also used extensively in the development of this program was the
  4641.     Technojock's Turbo Toolkit version 5.0 by Technojock Software. This is
  4642.     a shareware Borland Turbo Pascal toolkit whose registration we can
  4643.     100% recommend to all other Turbo Pascal programmers!
  4644.  
  4645.     This manual was composed using Buttonware's PC-TYPE.
  4646.  
  4647.     Finally, for those that are interested, COSWORTH was named after my
  4648.     cat and has nothing whatsoever to do with the Ford motor company.
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.     We thought you might like to know!
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.     COSWORTH COMMUNICATIONS SOFTWARE - About Cosworth               page 71
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.     TROUBLESHOOTING
  4694.     ---------------
  4695.  
  4696.     As PC communications is an area of computing more liable to the
  4697.     vagaries hardware and installed software, you may experience some
  4698.     problems in running COSWORTH. Here are some of the more common
  4699.     problems and their remedies;
  4700.  
  4701.     - Immediately on entering terminal mode, the connect tone (if set)
  4702.       sounds and the status line shows a connection.
  4703.  
  4704.       You have probably enabled the carrier override on your modem.
  4705.       COSWORTH requires the carrier detect to be false when not connected
  4706.       to another computer and on when it is. Since your modem has been set
  4707.       to automatically provide a carrier, COSWORTH assumes it is connected
  4708.       as soon as it enters terminal mode. If your modem has DIP switches,
  4709.       check their setting to ensure the carrier detect switch is set to
  4710.       off. If the modem does not have such switches then it will probably
  4711.       require particular commands to be sent to it (within the
  4712.       initialisation string set up in the modem strings section) to disable
  4713.       the automatic carrier.
  4714.  
  4715.     - On entering terminal mode or on commencing dialling, you receive a
  4716.       message stating that COSWORTH cannot initialise the COM port.
  4717.  
  4718.       In the Ports section of the configuration, COSWORTH detects how many
  4719.       serial ports you have and only offers you the choice of the existing
  4720.       ports. However, it may be that you have a non-standard set up and
  4721.       that COSWORTH has offered you the choice of more serial ports than
  4722.       your machine physically has. If you select one of these ports then
  4723.       COSWORTH will not be able to initialise that port.
  4724.  
  4725.     - You can initialise the serial port but on checking the set baud rate
  4726.       (by an internal modem diagnostic command, for example) it has not
  4727.       been set in accordance with your command.
  4728.  
  4729.       It is possible that you have a resident Fossil driver installed which
  4730.       is set up to lock your serial port at a particular baud rate. Since
  4731.       Fossil drivers hook into DOS interrupt 14h (Serial Port Services),
  4732.       further 'conventional' attempts to access the port will be ignored.
  4733.       Either reinstall the Fossil with the settings you will be using or
  4734.       (more preferably, if possible) deinstall the Fossil driver altogether
  4735.       when running COSWORTH.
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.     COSWORTH COMMUNICATIONS SOFTWARE - Troubleshooting              page 72
  4751.     (Appendix 1)
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.     - Your modem refuses to drop the carrier when you hang up the modem.
  4760.  
  4761.       When COSWORTH disconnects your modem, it will first of all try to
  4762.       lower the DTR on your serial port in an effort to drop the carrier.
  4763.       This ought to work with most modems, but some will not respond to
  4764.       this. In order to overcome this, COSWORTH will then, if a carrier
  4765.       signal remains, send the hang up string you have specified to the
  4766.       modem. If this fails then either you have specified the wrong hang up
  4767.       string for your modem (bear in mind that some hang up strings require
  4768.       pauses embedded in them to work) or you have probably enabled the
  4769.       carrier override on your modem. If this is enabled then any attempt
  4770.       to either lower the DTR or hang up the modem by a command string will
  4771.       fail since your modem is generating the carrier signal. If your modem
  4772.       has DIP switches, check their setting to ensure the carrier detect
  4773.       switch is set to off. If the modem does not have such switches then
  4774.       it will probably require particular commands to be sent to it (within
  4775.       the initialisation string set up in the modem strings section) to
  4776.       disable the automatic carrier. COSWORTH will attempt to send the hang
  4777.       up string to your modem up to ten times before telling you that the
  4778.       hang up failed. If the error appears then it is most likely that the
  4779.       carrier override facility in your modem has been enabled.
  4780.  
  4781.     - When dialling through the dialling directory, COSWORTH doesn't stop
  4782.       dialling on an engaged line until the dialling time on the status
  4783.       bar has reached zero.
  4784.  
  4785.       In order for COSWORTH to know when a line is engaged or otherwise
  4786.       unavailable, you must specify the strings your modem returns in the
  4787.       busy strings section of the modem strings configuration. If you have
  4788.       not specified all the strings your modem returns on a failed
  4789.       connection, then do so. If you have then it may be that you have not
  4790.       specified a high enough 'X' code in your initialisation string in
  4791.       order to return all the strings. In general, set the 'X' code to be
  4792.       as high as the modem will accept. Consult your modem manual for
  4793.       information as to what strings it returns and what the maximum 'X'
  4794.       code it can take is.
  4795.  
  4796.     - Some capture files seem to contain the correct characters but in the
  4797.       wrong sequence.
  4798.  
  4799.       This is probably because the screen you were viewing at the time was
  4800.       an animated ANSI editor which positions the cursor and characters at
  4801.       non-sequential positions on the screen. There isn't much you can do
  4802.       with this, since COSWORTH processes capture files directly from the
  4803.       serial port and not from the screen.
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.     COSWORTH COMMUNICATIONS SOFTWARE - Troubleshooting              page 73
  4817.     (Appendix 1)
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.     - On starting up terminal mode, Auto Dialler or commencing dialling
  4826.       from the directory, you receive an error message informing you that
  4827.       there is no modem attached to your serial port.
  4828.  
  4829.       When starting up in these modes, COSWORTH will first attempt to
  4830.       detect whether or not you have a live and working modem attached to
  4831.       your serial port. If you don't then an error will flash on the screen
  4832.       and you will be sent back to the main menu. If you DO have a working
  4833.       modem on the serial port in question then try restarting COSWORTH
  4834.       with the /NOCHECKING command line switch. Auto checking like this
  4835.       does not work with all modems and can sometimes fail under
  4836.       multitasking systems like Microsoft Windows.
  4837.  
  4838.     - Learned script files don't work as you'd expect.
  4839.  
  4840.       The problem here is probably that the script file is waiting for a
  4841.       prompt that will never arrive. The greatest possibility here is that
  4842.       the prompt is somehow 'animated' and that COSWORTH is not
  4843.       interpreting it correctly. For example, in the following instance
  4844.  
  4845.                          Is your name JOE BLOGGS? (Y)
  4846.  
  4847.       you may find that the cursor is sitting under the 'Y' character
  4848.       having been backtracked by ANSI escape sequences from the end of the
  4849.       line. At the moment, COSWORTH cannot handle this kind of prompt
  4850.       properly. It doesn't occur very often, but when it does it will halt
  4851.       the script. Your best bet here is to reduce the above RECEIVE prompt
  4852.       down to a simple
  4853.  
  4854.                       RECEIVE "Is your name JOE BLOGGS?"
  4855.  
  4856.       thereby getting around the 'animated' section of the prompt.
  4857.  
  4858.     - Pressing ESCAPE to halt dialling from the dialling directory quits
  4859.       back to the dialling directory but the dialling continues.
  4860.  
  4861.       When cancelling dialling in this manner, COSWORTH will (among other
  4862.       things) send your 'reset modem' string to the serial port. Now some
  4863.       modems may also require to be put into 'command mode' prior to
  4864.       receiving this string. If you find that pressing escape whilst
  4865.       dialling leaves a dialling tone (or even leaves the modem dialling)
  4866.       then precede your 'reset modem' string with your modem's escape code
  4867.       sequence. In the case of Hayes compatible modems this will mean
  4868.       changing your 'reset modem' string from 'ATZ^M' to '+++ATZ^M'
  4869.  
  4870.     - When shelling to DOS and returning to COSWORTH whilst on line, part
  4871.       or all of the text received in that interim period has been lost.
  4872.  
  4873.       This is because of the fact that COSWORTH is both interrupt driven
  4874.       and swaps itself out to XMS, EMS or disk file whilst shelling out.
  4875.       As a result, hardly any active portion of COSWORTH is left in RAM
  4876.       to operate. The trick here is not to shell out whilst there is text
  4877.       being received when on line!
  4878.  
  4879.  
  4880.  
  4881.  
  4882.     COSWORTH COMMUNICATIONS SOFTWARE - Troubleshooting              page 74
  4883.     (Appendix 1)
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.     COSWORTH ERROR MESSAGES
  4892.     -----------------------
  4893.  
  4894.     From time to time, things go wrong. <sigh> When they go wrong within
  4895.     COSWORTH, you will get a nice big (and hopefully helpful) error box
  4896.     plastered over the screen which will carry on it a numbered error
  4897.     message telling you exactly WHAT has gone wrong and where.
  4898.  
  4899.     All errors are displayed on the screen and are also written out into
  4900.     the COSWORTH.ERF error message file, in case you missed them.
  4901.  
  4902.     Incidentally, most of the file errors ought not to occur. COSWORTH
  4903.     automatically sets the attributes of all its support files to Archive
  4904.     when starting up.
  4905.  
  4906.     FATAL ERRORS
  4907.     ------------
  4908.  
  4909.     Some errors are so bad that they force COSWORTH to stop in its tracks!
  4910.     These errors are displayed as follows;
  4911.  
  4912.     Message : COSWORTH.EXE HAS BEEN ILLEGALLY ALTERED - PROGRAM ABORTING
  4913.     Meaning : COSWORTH isn't quite what it used to be.
  4914.     Remedy  : When COSWORTH starts up it examines itself to ensure that
  4915.               the COSWORTH.EXE program has not been altered in any way. If
  4916.               it has then this error appears and everything stops. To
  4917.               remedy this, delete COSWORTH.EXE and reinstall it from a
  4918.               back up. Oh yes, and stop messing about with it!
  4919.  
  4920.     Message : CONFIGURATION FILE CORRUPTED! RESTART COSWORTH!
  4921.     Meaning : The file COSWORTH.CFG has become seriously corrupted.
  4922.     Remedy  : Restart COSWORTH. This error should only ever occur if the
  4923.               configuration file becomes corrupted between COSWORTH
  4924.               reading it when it starts up and some other point within the
  4925.               program's execution. By restarting COSWORTH, the program
  4926.               will handle the corruption and will reconstruct the file
  4927.               with defaults which it will allow you to edit.
  4928.  
  4929.     Message : CANNOT READ DIRECTORY! ABORTING PROGRAM!
  4930.     Meaning : Whichever directory you are starting COSWORTH up with, it
  4931.               has become unreadable.
  4932.     Remedy  : Restart COSWORTH with the /DIR switch, specifying another
  4933.               dialling directory. Delete the offending directory from your
  4934.               disk and restore it from a back up. You do have back ups,
  4935.               don't you?
  4936.  
  4937.     Message : CANNOT AUTO DIAL AS CONTROL FILE DOES NOT EXIST!
  4938.     Meaning : You've tried to start Auto Dialling on a non-existent
  4939.               control file!
  4940.     Remedy  : You have started up COSWORTH from the command line with the
  4941.               /AUTO switch and specified a-non existent control file name.
  4942.               Simply restart COSWORTH with a file name that exists.
  4943.               This is identical to error #27 listed below but will
  4944.               only be displayed if your are Auto Dialling from the DOS
  4945.               command line with the /AUTO switch.
  4946.  
  4947.  
  4948.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 75
  4949.     (Appendix 2)
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.     Message : AUTO DIALLING TERMINATED - DIRECTORY NOT FOUND!
  4958.     Meaning : You've tried to start Auto Dialling on a non-existent
  4959.               dialling directory, probably as a result of setting up the
  4960.               Auto Dialler control file and then either deleting or
  4961.               renaming its associated dialling directory.
  4962.     Remedy  : If you've just renamed the directory then rename it back! If
  4963.               you've deleted it then undelete it (if you can) or delete
  4964.               the Auto Dialler control file and start again.
  4965.  
  4966.     The only other mega-scary fatal error you will ever get from COSWORTH
  4967.     is an internal failure error which displays itself as 'SYSTEM ERROR AT
  4968.     <numbers> ERROR CODE = <number>'. We have hopefully ironed out all the
  4969.     bugs from COSWORTH so that you will never see this error. However, if
  4970.     you do then note the numbers and contact the programmers on the BBS
  4971.     listed in the READ.ME file.
  4972.  
  4973.  
  4974.     NON-FATAL ERRORS
  4975.     ----------------
  4976.  
  4977.     These are the other errors that COSWORTH generates, together with
  4978.     their listed numbers (fatal errors are given the nominal error value
  4979.     of 1), their meanings and the remedy. Words in <angled brackets>
  4980.     signify that the error message will incorporate a some variable
  4981.     element.
  4982.  
  4983.     Message : SCRIPT FILE TIME OUT! - SCRIPT FILE ABORTED!
  4984.     Number  : 2
  4985.     Meaning : The script file you are running has not received the string
  4986.               it is expecting within the default time out period.
  4987.     Remedy  : Examine the script file and make sure the prompts are still
  4988.               valid. If they aren't then you might consider relearning the
  4989.               script by deleting it and reconnecting to the remote system.
  4990.               If the prompt is correct than it's likely that you're
  4991.               needing a WAIT command preceding the RECEIVE. If the script
  4992.               is timing out immediately after a file transfer then try
  4993.               using a WAIT with no parameters, otherwise try increasing
  4994.               the time out by thirty seconds with WAIT 30. If you already
  4995.               have a WAIT command in your script at this point then try
  4996.               incrementing it by, say, thirty seconds until a suitable
  4997.               length of time is reached.
  4998.  
  4999.     Message : CANNOT WRITE TO COSWORTH PHONE DIRECTORY!
  5000.     Number  : 3
  5001.     Meaning : Something is stopping the phone directory from updating.
  5002.     Remedy  : This could be due to a full disk or to a disk error. It
  5003.               could also be caused by you shelling to DOS during COSWORTH
  5004.               and setting the Read Only attribute on the file!
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 76
  5015.     (Appendix 2)
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.     Message : NO CONNECT STRING RECEIVED!
  5024.     Number  : 4
  5025.     Meaning : COSWORTH has managed to get a signal carrier but has
  5026.               received no connect string that it recognises from the
  5027.               modem.
  5028.     Remedy  : Check your modem string settings. It may be that you have
  5029.               set up a connect string which your modem will not generate.
  5030.  
  5031.     Message : DIRECTORY <file> IS EMPTY, CANNOT AUTODIAL!
  5032.     Number  : 5
  5033.     Meaning : You've tried to create an Auto Dialler control file using a
  5034.               blank dialling directory.
  5035.     Remedy  : In future, don't use blank dialling directories...
  5036.  
  5037.     Message : SCRIPT FILE TIMED OUT ON AUTO DIALLER!
  5038.     Number  : 6
  5039.     Meaning : The script file timed out during an Auto Dialler session.
  5040.     Remedy  : If a script file times out and therefore closed during the
  5041.               Auto Dialler then the carrier is unceremoniously dropped. Why
  5042.               did the script file time out on you? Examine the script file
  5043.               and make sure the prompts are still valid. If they aren't
  5044.               then you might consider relearning the script by deleting it
  5045.               and reconnecting to the remote system. If the prompt is
  5046.               correct than it's likely that you're needing a WAIT command
  5047.               preceding the RECEIVE. If the script is timing out
  5048.               immediately after a file transfer then try using a WAIT with
  5049.               no parameters, other wise try increasing the time out by
  5050.               thirty seconds with WAIT 30. If you already have a WAIT
  5051.               command in your script at this point then try incrementing it
  5052.               by, say, thirty seconds until a suitable length of time is
  5053.               reached.
  5054.  
  5055.     Message : CANNOT AUTO DIAL, NO SCRIPT FILE FOR <Remote System> !
  5056.     Number  : 7
  5057.     Meaning : You've tried to create an Auto Dialler control file for a
  5058.               remote system for which there is no associated script file
  5059.               in the copy of the dialling directory entry held in the Auto
  5060.               Dialler Control file.
  5061.     Remedy  : Either choose an entry which *does* have an associated
  5062.               script file, or back out of the Auto Dialler menus and check
  5063.               the dialling directory entry. Remember, the Auto Dialler
  5064.               control file editor does *not* check for the physical
  5065.               presence of the script file, only that there is an entry for
  5066.               one in the dialling directory. (If there is no script file
  5067.               found at dialling time then the Auto Dialler won't even dial
  5068.               the number but will continue onto the next number in the
  5069.               queue.)
  5070.  
  5071.  
  5072.  
  5073.  
  5074.  
  5075.  
  5076.  
  5077.  
  5078.  
  5079.  
  5080.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 77
  5081.     (Appendix 2)
  5082.  
  5083.  
  5084.  
  5085.  
  5086.  
  5087.  
  5088.  
  5089.     Message : AUTO DIAL HALTED - NO DATA RECEIVED FROM <Remote System> !
  5090.     Number  : 8
  5091.     Meaning : Auto Dialler has not received any data from the remote
  5092.               system within the past 'x' seconds where 'x' is the time
  5093.               after which the Auto Dialler will hang up if no data is
  5094.               received (the Auto Dialler Time Out set in the Configuration
  5095.               menu)
  5096.     Remedy  : It's probable that your script file is either set up for the
  5097.               wrong prompts or else the remote system is sending different
  5098.               prompts from those in the script (which is possible). It
  5099.               could also be that the remote system has 'hung'. Try running
  5100.               the script file in real time (ie, without using the Auto
  5101.               Dialler) and see what happens. If the script still fails
  5102.               then try relearning the script by deleting it and calling
  5103.               again manually.
  5104.  
  5105.     Message : CANNOT CREATE <File Name> !
  5106.     Number  : 9
  5107.     Meaning : COSWORTH has had difficulty in creating one of its support
  5108.               files.
  5109.     Remedy  : This could be due to any one of a number of disk or physical
  5110.               Input/Output errors. This error is identical to that in
  5111.               error #19.
  5112.  
  5113.     Message : NO MODEM DETECTED ON COM PORT <Port Number> !
  5114.     Number  : 10
  5115.     Meaning : COSWORTH has entered the dialling procedure or has started
  5116.               up terminal mode or has started auto dialling and COSWORTH
  5117.               cannot find a working modem attached to the serial port set
  5118.               up in the Configuration menu.
  5119.     Remedy :  If the port number in the Configuration menu is wrong then
  5120.               change it. If the Port Number is correct then the problem
  5121.               may be one of a few things. Try restarting COSWORTH with the
  5122.               /NOCHECKING parameter to disable checking for a modem in
  5123.               this manner. This can sometimes happen when all is otherwise
  5124.               well if COSWORTH is running under Microsoft Windows.
  5125.  
  5126.     Message : COULD NOT UPLOAD <File Name>  - DOS ERROR <Code>
  5127.     Number  : 11
  5128.     Meaning : The external protocol you were using to execute the upload
  5129.               returned a non-zero DOS ERRORLEVEL.
  5130.     Remedy  : It may be that the file did not exist. It is also possible
  5131.               that the file transfer was flawless but that the protocol
  5132.               program returned a non-zero ERRORLEVEL anyway (maybe due to a
  5133.               number of time outs). Check the for existence of the file in
  5134.               the upload directory. Also, check through the protocol log
  5135.               file (if you have one set up - generated by the protocol
  5136.               program, not COSWORTH!) for any errors.
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 78
  5147.     (Appendix 2)
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.     Message : COULD NOT DOWNLOAD <File Name>  - DOS ERROR <Code>
  5156.     Number  : 12
  5157.     Meaning : The external protocol you were using to execute the download
  5158.               returned a non-zero DOS ERRORLEVEL.
  5159.     Remedy  : It may be that the file did not exist. It is also possible
  5160.               that the file transfer was flawless but that the protocol
  5161.               program returned a non-zero ERRORLEVEL anyway (maybe due to a
  5162.               number of time outs). Check the for existence of the file in
  5163.               the download directory. Also, check through the protocol log
  5164.               file (if you have one set up - generated by the protocol
  5165.               program, not COSWORTH!) for any errors.
  5166.  
  5167.     Message : SCRIPT FILE ERROR - COULD NOT DELETE <File Name>
  5168.     Number  : 13
  5169.     Meaning : You have attempted to delete an 'undeletable' file using the
  5170.               DELETE script file command.
  5171.     Remedy  : Either the file did not exist in the first place, it is set
  5172.               to Read Only or there has been a disk read/write error.
  5173.  
  5174.     Message : CANNOT CREATE - "COSWORTH.MAC" MACRO FILE
  5175.     Number  : 14
  5176.     Meaning : COSWORTH cannot recreate a 'lost' macro file.
  5177.     Remedy  : When COSWORTH starts up it checks for the presence of all
  5178.               its support files. If it cannot find the COSWORTH.MAC macro
  5179.               file then it tries to recreate a blank one. If this fails
  5180.               then this error is shown. You may have a full disk, or you
  5181.               might have experienced a disk I/O error.
  5182.  
  5183.     Message : TEXT FILE <File Name> DOES NOT EXIST!
  5184.     Number  : 15
  5185.     Meaning : A text file you are trying to upload by ALT-U doesn't exist.
  5186.     Remedy  : Try selecting the text file from the directory menu (called
  5187.               by pressing return on the blank input box) instead of typing
  5188.               the file name in. You've probably mis-spelled the name.
  5189.  
  5190.     Message : MINIMUM CONNECTION SPEED NOT REACHED!
  5191.     Number  : 16
  5192.     Meaning : The minimum speed compelled by the MINIMUM SPEED script file
  5193.               command was not reached on connection.
  5194.     Remedy  : Try calling again. The speed may have been downwardly
  5195.               renegotiated due to line noise. Alternatively, you might be
  5196.               specifying a minimum connection rate higher than that which
  5197.               the remote service or your modem can operate at!
  5198.  
  5199.     Message : CANNOT INITIALISE PORT COM <PORT NUMBER>
  5200.     Number  : 17
  5201.     Meaning : An error occurred whilst initialising the selected port.
  5202.     Remedy  : If your running COSWORTH with the /NOCHECKING parameter then
  5203.               try running it without it and see if COSWORTH reports the
  5204.               presence of a modem on the selected port. If it doesn't then
  5205.               ensure you're set up for the right serial port through the
  5206.               configuration menu. If you are then try changing the serial
  5207.               cable with which you connect to your modem.
  5208.  
  5209.  
  5210.  
  5211.  
  5212.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 79
  5213.     (Appendix 2)
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.     Message : CANNOT FIND READ FROM <File Name>
  5222.     Number  : 18
  5223.     Meaning : A file error happened during a disk read.
  5224.     Remedy  : The file may be corrupted (wrong length) or may make 'no
  5225.               sense' to COSWORTH. Alternatively, a disk hardware failure
  5226.               may have occurred. Try restoring the offending file from a
  5227.               back up. (Yes, those again!)
  5228.  
  5229.     Message : CANNOT CREATE <File Name>
  5230.     Number  : 19
  5231.     Meaning : COSWORTH has had difficulty in creating one of its support
  5232.               files.
  5233.     Remedy  : This could be due to any one of a number of disk or physical
  5234.               Input/Output errors. The disk may be full, there may be a
  5235.               disk read error, the file may have the Read Only attribute
  5236.               set. Try freeing up some disk space or setting all file
  5237.               attributes to Archive only. If the error persists then
  5238.               suspect the disk is faulty.
  5239.  
  5240.     Message : CANNOT APPEND DATA TO <File Name>
  5241.     Number  : 20
  5242.     Meaning : COSWORTH has had difficulty in appending (adding) data to
  5243.               one of its support files.
  5244.     Remedy  : This could be due to any one of a number of disk or physical
  5245.               Input/Output errors. The disk may be full, there may be a
  5246.               disk read error, the file may have the Read Only attribute
  5247.               set. Try freeing up some disk space or setting all file
  5248.               attributes to Archive only. If the error persists then
  5249.               suspect the disk is faulty.
  5250.  
  5251.     Message : CANNOT CLOSE <File Name> UPDATES MAY BE LOST!
  5252.     Number  : 21
  5253.     Meaning : A file that COSWORTH has previously opened cannot be closed
  5254.               and updated. Any changes made to the file (or even the file
  5255.               itself) may be permanently lost.
  5256.     Remedy  : This could be due to any one of a number of disk or physical
  5257.               Input/Output errors. The disk may be full, there may be a
  5258.               disk read error, the file may have the Read Only attribute
  5259.               set. In future, try freeing up some disk space or setting
  5260.               all file attributes to Archive only. If this error occurs
  5261.               then it is unlikely to be recoverable.
  5262.  
  5263.     Message : CURRENT SCRIPT FILE LOST ON PATH! ABORTING SCRIPT!
  5264.     Number  : 22
  5265.     Meaning : A script file being currently used has been 'lost'!
  5266.     Remedy  : One of two scenarios; either you're doing comms work in a
  5267.               multitasker and have deleted the script file whilst it was
  5268.               in use, or else you've got a problem with the logical
  5269.               structure of your disk. If the former then you probably
  5270.               deserve all you get...(!)...if the latter then disk
  5271.               recovery/diagnostic tools may be in order...
  5272.  
  5273.  
  5274.  
  5275.  
  5276.  
  5277.  
  5278.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 80
  5279.     (Appendix 2)
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.     Message : CANNOT READ FROM MACRO FILE! ASSUMING ALL MACROS ARE BLANK!
  5288.     Number  : 23
  5289.     Meaning : COSWORTH has failed to read from the COSWORTH.MAC macro
  5290.               definition file and is assuming that no macros are
  5291.               specified.
  5292.     Remedy  : The macro file may be corrupted (ie, the wrong length).
  5293.               When COSWORTH starts up it checks for the presence of all
  5294.               its support files. If it cannot find the COSWORTH.MAC macro
  5295.               file then it tries to recreate a blank one. If you get this
  5296.               error after the macro file has been created (without error)
  5297.               then you may have a disk problem.
  5298.  
  5299.     Message : CANNOT DELETE <File Name>
  5300.     Number  : 24
  5301.     Meaning : COSWORTH cannot delete the specified file.
  5302.     Remedy  : The file attributes may be set to read only, or the file may
  5303.               not even exist!
  5304.  
  5305.     Message : CANNOT READ FROM <File Name>
  5306.     Number  : 25
  5307.     Meaning : COSWORTH cannot read from the specified file.
  5308.     Remedy  : The file specified may not exist or you may be experiencing
  5309.               a disk problem. Alternatively, the file attributes may be
  5310.               set to System or Hidden.
  5311.  
  5312.     Message : CANNOT WRITE TO <File Name>
  5313.     Number  : 26
  5314.     Meaning : COSWORTH cannot write to the specified file.
  5315.     Remedy  : This could be due to any one of a number of disk or physical
  5316.               Input/Output errors. The disk may be full, there may be a
  5317.               disk read error, the file may have the Read Only attribute
  5318.               set. Try freeing up some disk space or setting all file
  5319.               attributes to Archive only. If the error persists then
  5320.               suspect the disk is faulty.
  5321.  
  5322.     Message : CANNOT AUTO DIAL AS CONTROL FILE <File Name> DOES NOT EXIST!
  5323.     Number  : 27
  5324.     Meaning : You've tried to start Auto Dialling on a non-existent
  5325.               control file!
  5326.     Remedy  : The only way you could *possibly* manage this spectacular
  5327.               trick is by starting up the Auto Dialler menu (which detects
  5328.               and lists all the control files available) and then somehow
  5329.               deleting the control file in the interim period (maybe by
  5330.               doing it through a multitasking system like Windows or
  5331.               DESQview). This is identical to the fatal error listed above
  5332.               but will only be displayed if your are Auto Dialling from
  5333.               within COSWORTH. This error will NOT abort the program.
  5334.  
  5335.     Message : CANNOT FIND COSWORTH.EXE ON PROGRAM PATH! - PLEASE RE-ENTER!
  5336.     Number  : 28
  5337.     Meaning : You've entered a path in the configuration PATHS menu which
  5338.               does not contain COSWORTH.EXE.
  5339.     Remedy  : Either enter the correct path or, if you are unsure, quit
  5340.               the menu with ESC, don't save changes and check the
  5341.               directory contents from DOS.
  5342.  
  5343.  
  5344.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 81
  5345.     (Appendix 2)
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.     Message : FILE OR PATHNAME DOES NOT EXIST! - SELECT FROM MENU!
  5354.     Number  : 29
  5355.     Meaning : You've attempted to execute a file transfer by using an
  5356.               invalid (or non-existent) file or path to that file.
  5357.     Remedy  : Check the paths set in your configuration set up. Ensure
  5358.               that you haven't deleted the directories that the upload or
  5359.               download paths refer to. Alternatively, it may be that the
  5360.               file you are attempting to upload does not exist.
  5361.  
  5362.     Message : MAXIMUM AUTO DIALLER CONNECTION TIME EXCEEDED!
  5363.     Number  : 30
  5364.     Meaning : Your Auto Dialler session has been terminated by COSWORTH
  5365.               detecting that you have reached the maximum time period you
  5366.               have allocated for that call.
  5367.     Remedy  : Check to see you allocated enough time for the call.
  5368.               Although unlikely, it may also be that you have a WAIT
  5369.               command (with no passed arguments) awaiting a string from the
  5370.               remote system and Auto Dialler and Script File time outs (set
  5371.               in the Program Settings section) set to longer than the
  5372.               allowed duration of the call.
  5373.  
  5374.     Message : <File Name> NOT FOUND!
  5375.     Number  : 31
  5376.     Meaning : COSWORTH cannot find the external protocol program file.
  5377.     Remedy  : You have set up the protocols through COSWORTH and have then
  5378.               deleted the protocol program. Either restore the program to
  5379.               the protocol directory or select a new protocol to use.
  5380.  
  5381.     Message : NO REPLY RECEIVED FROM MODEM!
  5382.     Number  : 32
  5383.     Meaning : COSWORTH has sent either the RESET MODEM or INITIALISE MODEM
  5384.               strings to the port from the dialling directory and has
  5385.               failed to receive a response of any kind from your modem.
  5386.     Remedy  : If you have started COSWORTH with the /NOCHECKING switch
  5387.               then check your modem is switched on and plugged in. If this
  5388.               is not the case then ensure that your serial cable is
  5389.               intact. If this error persists and you are certain that
  5390.               your modem is working then contact the authors.
  5391.  
  5392.     Message : MODEM ERROR STRING RECEIVED ON SENDING <name> STRING!
  5393.     Number  : 33
  5394.     Meaning : COSWORTH has sent either the RESET MODEM or INITIALISE MODEM
  5395.               strings to the port from the dialling directory and has
  5396.               received the specified 'MODEM ERROR' string back from your
  5397.               modem.
  5398.     Remedy  : Check that the strings you're specifying are valid strings
  5399.               for the modem being used.
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.     COSWORTH COMMUNICATIONS SOFTWARE - Error Messages               page 82
  5411.     (Appendix 2)
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.     XCOS FILE TRANSFER PROTOCOL
  5420.     ---------------------------
  5421.  
  5422.     COSWORTH comes complete with its own file transfer protocol called
  5423.     XCOS.EXE which implements the Xmodem protocol standard. This will
  5424.     allow you to get online to other systems straight away and download
  5425.     e-mail messages or software (probably better protocols!) straight
  5426.     away.
  5427.  
  5428.     We don't claim that XCOS is the last word in transfer protocols - it
  5429.     would be silly to try to compete with them - but we do claim that it
  5430.     does the job that is expected of it and operates at a reasonably
  5431.     efficient rate.
  5432.  
  5433.     XCOS is automatically installed into your COSWORTH.PTL protocol
  5434.     definition file by the INSTALL program, but we thought it best we
  5435.     document the program in any case!
  5436.  
  5437.  
  5438.     USING XCOS
  5439.     ----------
  5440.  
  5441.     Use of this protocol program is really very simple indeed. Its
  5442.     possible command line parameters are;
  5443.  
  5444.      XCOS.EXE [COMPORT Port] [BAUD Baud] Command [Options] Path/Filename
  5445.  
  5446.     The [bracketed] switches indicate that these switches are optional to
  5447.     the running of the program. The words in capital letters (if used)
  5448.     must appear as written, whereas the words in mixed case are variable,
  5449.     indicating that they can take one of at least two values. The program
  5450.     switches mean the following;
  5451.  
  5452.     [COMPORT Port] - This informs XCOS which serial port to use for the
  5453.                      data transmission. If this parameter is omitted
  5454.                      altogether then COM1 will be assumed.
  5455.  
  5456.     [BAUD Baud]    - This informs XCOS at which speed the transfer is to
  5457.                      be made at. It can take any of the standard COSWORTH
  5458.                      baud rates of 300, 1200, 2400, 4800, 7200, 9600,
  5459.                      12000, 14400, 19200 or 38400 baud. If this parameter
  5460.                      is omitted the current baud rate (as set by COSWORTH)
  5461.                      is used.
  5462.  
  5463.     Command        - This tells XCOS what operation it is to perform. If
  5464.                      this parameter is set as 'RX' you will be in receive
  5465.                      (download mode). If it is set to 'SX' then you will
  5466.                      be in send (upload) mode.
  5467.  
  5468.     [Options]      - You can choose from '-C' for a CRC mode transfer or
  5469.                      '-K' for a 1K Xmodem transfer. If you omit this
  5470.                      parameter then the transfer will revert to 128 byte
  5471.                      block Xmodem Checksum.
  5472.  
  5473.  
  5474.  
  5475.  
  5476.     COSWORTH COMMUNICATIONS SOFTWARE - XCos Protocol                page 83
  5477.     (Appendix 3)
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.     Path/Filename  - This parameter tells XCOS which file is to be sent or
  5486.                      received or which path the file lies on. You cannot
  5487.                      specify a DOS wildcard as Xmodem does not support
  5488.                      batch (multiple file) transfers.
  5489.  
  5490.     Once the program is running you will see a display on the screen
  5491.     something similar to this;
  5492.  
  5493.  
  5494.     XCOS Xmodem                                         PRESS ESC TO ABORT
  5495.     Written for COSWORTH COMMUNICATIONS SOFTWARE
  5496.     (c) D.Carroll, M.Dickson Opus Programs 1992
  5497.  
  5498.     Command line : XCOS COMPORT 1 BAUD 19200 SX -C A_FILE.ZIP
  5499.     Using serial port COM1 at 19200 baud
  5500.     Sending Xmodem.....A_FILE.ZIP
  5501.  
  5502.           ╔════════════════════════════════════════════════════════╗
  5503.           ║                                                        ║
  5504.           ║   FILE NAME             A_FILE.ZIP                     ║
  5505.           ║   FILE SIZE             62487                          ║
  5506.           ║   PROTOCOL MODE         Xmodem Checksum                ║
  5507.           ║   BLOCK NUMBER          232                            ║
  5508.           ║   BYTES SENT            29696                          ║
  5509.           ║   CHARS PER SECOND      478                            ║
  5510.           ║   ELAPSED TIME          1 min. 2 sec.                  ║
  5511.           ║   BLOCK ERRORS          1                              ║
  5512.           ║   TOTAL ERRORS          1                              ║
  5513.           ║                                                        ║
  5514.           ╚════════════════════════════════════════════════════════╝
  5515.  
  5516.     As the transfer (in this case an Xmodem Checksum upload) the figures
  5517.     relating to the blocks and bytes sent/received will update according
  5518.     to the current status of the transfer. You can abort the transfer at
  5519.     any time by pressing the escape key and waiting for a second or two.
  5520.  
  5521.  
  5522.     ERRORS
  5523.     ------
  5524.  
  5525.     When the program exits, an error code, detectable through the DOS
  5526.     ERRORLEVEL in batch files, (if you really feel like doing that, that
  5527.     is!) is returned. In addition, the error message associated with the
  5528.     particular condition is displayed at the foot of the screen. The
  5529.     following are all the error codes that XCOS can return, together with
  5530.     their meanings;
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.  
  5542.     COSWORTH COMMUNICATIONS SOFTWARE - XCos Protocol                page 84
  5543.     (Appendix 3)
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.     Error Code     Meaning
  5552.  
  5553.          0         The transfer completed without error.
  5554.          1         There was an error in addressing the file to be
  5555.                    uploaded or in creating the file to be downloaded. In
  5556.                    the former instance this could mean that the file may
  5557.                    not exist or that the disk is corrupted. In the latter
  5558.                    case it may mean that the disk is write-protected or
  5559.                    full.
  5560.          2         You aborted the file transfer with the escape key.
  5561.          3         The remote system aborted the transfer.
  5562.          4         The maximum number of ten time outs, block errors or
  5563.                    other associated error conditions has been exceeded
  5564.                    and the transfer has been aborted. This may be due to
  5565.                    noisy telephone lines.
  5566.          5         A block was transferred and received out of sequence.
  5567.                    If this happens then the program aborts without
  5568.                    hesitation!
  5569.          6         There was a time out in waiting for the remote system
  5570.                    sending an End Of Transmission character. This is not
  5571.                    normally a problem unless the file appears to be
  5572.                    corrupted.
  5573.          7         No carrier detected on the serial port.
  5574.          8         An invalid operation was requested from the command
  5575.                    line parameters . Operations can only be either 'SX' or
  5576.                    'RX'.
  5577.          9         An invalid option was requested from the command line
  5578.                    parameters . Operations can only be either '-C' or '-K'.
  5579.          10        An invalid baud rate was specified on the command line.
  5580.          11        An invalid serial port number was specified on the
  5581.                    command line.
  5582.  
  5583.  
  5584.     EXAMPLES
  5585.     --------
  5586.  
  5587.  
  5588.     Examples of the use of XCOS are:
  5589.  
  5590.     Specify Xmodem Checksum send, COM1, current baud:
  5591.  
  5592.                                                XCOS sx A_FILE.ZIP
  5593.  
  5594.     Specify Xmodem CRC send, COM1, current baud:
  5595.  
  5596.                                                XCOS sx -c A_FILE.ZIP
  5597.  
  5598.     Specify Xmodem 1K send, COM1, current baud:
  5599.  
  5600.                                                XCOS sx -k A_FILE.ZIP
  5601.                                                XCOS sx -k -c A_FILE.ZIP
  5602.  
  5603.     Specify Xmodem Checksum receive, COM1, current baud:
  5604.  
  5605.                                                XCOS rx A_FILE.ZIP
  5606.  
  5607.  
  5608.     COSWORTH COMMUNICATIONS SOFTWARE - XCos Protocol                page 85
  5609.     (Appendix 3)
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.  
  5616.  
  5617.  
  5618.     Specify Xmodem CRC or 1K receive, COM1, current baud:
  5619.  
  5620.                                                XCOS rx -c A_FILE.ZIP
  5621.                                                XCOS rx -c -k A_FILE.ZIP
  5622.                                                XCOS rx -k A_FILE.ZIP
  5623.  
  5624.     ( Note that all three of these commands will receive Xmodem 1K or
  5625.     Xmodem CRC, whichever the remote system decides to send. As always, if
  5626.     the remote system does not support CRC, the protocol will drop back to
  5627.     Xmodem Checksum. All Xmodem 1K transfers are assumed to be CRC by
  5628.     default.)
  5629.  
  5630.     Specify Xmodem Checksum send, COM2, current baud rate:
  5631.  
  5632.                                                XCOS port 2 sx A_FILE.ZIP
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.     COSWORTH COMMUNICATIONS SOFTWARE - XCos Protocol                page 86
  5675.     (Appendix 3)
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.     GLOSSARY OF TERMS
  5684.     -----------------
  5685.  
  5686.     Anything to do with computer communications is a minefield of jargon
  5687.     and esoteric terminology. What follows below is an attempt to
  5688.     consolidate some of the terms used in the field of comms. It's not
  5689.     meant to be completely exhaustive, nor it is supposed to be
  5690.     particularly detailed, but it's a start!
  5691.  
  5692.     ARQ - Automatic Repeat Request. This is a generalised term for error
  5693.          correction methods which have the ability to re-request corrupted
  5694.          data blocks.
  5695.  
  5696.     ASYNCHRONOUS TRANSMISSION - Probably the most common form of data
  5697.          transference where both the transmitting and receiving modems do
  5698.          not run in synchronisation with each other. Data is sent with
  5699.          'start' and 'stop' bits allowing each modem to know when to start
  5700.          and when to stop.
  5701.  
  5702.     AUTO ANSWER MODE - When a modem is in auto answer mode it can answer
  5703.          incoming calls from other modems.
  5704.  
  5705.     BAUD - The baud rate signifies the modems speed and is roughly (at
  5706.          lower speeds anyway) analogous to the bits transferred per
  5707.          second. It is more accurately described as being the number of
  5708.          discrete signal events occurring on the channel. 1200 baud means
  5709.          that roughly 1200 bits are being transferred (in either
  5710.          direction) at any one time. As each byte is composed of two bits
  5711.          and there are usually two bits added for the asynchronous
  5712.          transfer, the transferred bits per second is roughly the baud
  5713.          rate divided by ten. Incidentally, the word 'baud' is a
  5714.          contraction of the name of the Frenchman (Baudot) who invented a
  5715.          very old communications code for teletype machines.
  5716.  
  5717.     CARRIER SIGNAL - A carrier the a continuous frequency which can be
  5718.          either modulated or embedded with the data being transmitted by
  5719.          another signal. Carriers are generated and maintained by the
  5720.          modem.
  5721.  
  5722.     CRC - Cyclic Redundancy Checking. An error correction method which
  5723.          consists of an algorithm enacted upon every block of data
  5724.          received or sent by a modem. The sending modem embeds it CRC
  5725.          calculations within each block and the receiving modem compares
  5726.          this figure with the one it independently reached. If the figures
  5727.          agree then the receiving modem sends an acknowledgement character
  5728.          (ACK) or of negative an acknowledgement character (NAK) if it
  5729.          disagrees.
  5730.  
  5731.     CTS - Clear To Send, an RS232 signal.
  5732.  
  5733.  
  5734.  
  5735.  
  5736.  
  5737.  
  5738.  
  5739.  
  5740.     COSWORTH COMMUNICATIONS SOFTWARE - Glossary                     page 87
  5741.     (Appendix 4)
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.     DATA COMPRESSION - As telephone communications are relatively
  5750.          expensive, particularly over longer distances, it helps to stores
  5751.          the information in your files in a compressed format which allows
  5752.          the data to be transmitted faster and hence cheaper. Compression
  5753.          is usually taken place prior to transmission by specific
  5754.          software, but it can also be done whilst the transmission is in
  5755.          progress using MNP 5.
  5756.  
  5757.     DCD - Data Carrier Detect, an RS232 signal.
  5758.  
  5759.     DOWNLOADING - Receiving data (usually in the form of a computer file)
  5760.          from a remote modem.
  5761.  
  5762.     DSR - Data set ready, an RS232 signal.
  5763.  
  5764.     DUPLEX - The direction of the data transfer. Half duplex means that
  5765.          only one modem can 'talk' at the one time, something like a two
  5766.          way radio. At full duplex, both modems can 'talk' at the same
  5767.          time, as in a telephone conversation.
  5768.  
  5769.     FALLBACK - When two modems talk for the first time they try to
  5770.          negotiate for the highest line speed possible. If they cannot do
  5771.          this then they fall back to the highest speed they can manage at.
  5772.          Fallback can also occur if the line conditions deteriorate and
  5773.          higher speed communications become impossible. Some modems have
  5774.          the capability of renegotiating the line speed once conditions
  5775.          become more favourable.
  5776.  
  5777.     HANDSHAKING - A method of compensating for the receiver having to
  5778.          break transfer briefly whilst it processes the data received.
  5779.          This can either be enabled by software (XON/XOFF) or by hardware
  5780.          (RTS/CTS).
  5781.  
  5782.     LAPM - Link Access Procedure for Modems, a sophisticated form of error
  5783.          correction for modems and built into V42.
  5784.  
  5785.     LEARN FACILITY - A capability of your comms software to monitor what
  5786.          you are typing at your keyboard and remember it, writing a script
  5787.          file for you in the process.
  5788.  
  5789.     LINE NOISE - Disturbances in the quality of the telephone line caused
  5790.          by adverse conditions, resulting in corruption of the data being
  5791.          transferred. If error checking modems or software is being used
  5792.          then the corrupted data will be rejected by the receiver and the
  5793.          transmitter will be forced to resend the data block.
  5794.  
  5795.     MODEM - A contraction of modulator/demodulator. Not all lines are
  5796.          constructed to convey digital signals, so the signals are
  5797.          converted into audio tones, a process known as modulation, which
  5798.          are passed over the telephone lines. The demodulation -
  5799.          converting sound to data - takes place at the receiving end.
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.  
  5806.     COSWORTH COMMUNICATIONS SOFTWARE - Glossary                     page 88
  5807.     (Appendix 4)
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815.     MNP - Microcom Networking Protocol, a standard method of error
  5816.          correction and a method of eliminating line noise. This is mostly
  5817.          implemented in modems although some forms of MNP occur in
  5818.          software. For MNP to work, both modems must be using it.
  5819.  
  5820.     PARITY - If you are only sending text files across the line then the
  5821.          eighth bit of each byte isn't actually used by the data and can
  5822.          be used for a simple form of error checking called parity
  5823.          checking. Both the receiving and transmitting systems must be
  5824.          using the same parity checking system. As transferring binary
  5825.          files involves the use of all eight bits of each byte, parity
  5826.          checking is set to none.
  5827.  
  5828.     PROTOCOL - A protocol is a series of rules which define the
  5829.          communications between two or more devices. The external protocol
  5830.          transfer programs you run, send and receive data in preordained
  5831.          ways according to the rules which they adhere to, hence the
  5832.          importance of ensuring that both sender and receiver are
  5833.          observing the protocol. Standard file transfer protocol standards
  5834.          are the Xmodem, Ymodem and Zmodem.
  5835.  
  5836.     RD - Receive Data, An RS-232 signal, often found represented in a
  5837.          light on the front of your modem. When the light is illuminated
  5838.          your are receiving data.
  5839.  
  5840.     REN - Ringer Equivalence Number, the electronic 'weight' that each
  5841.          telecommunications items carries and places on the line. You can
  5842.          connect items up to a total of 4REN on household British Telecom
  5843.          lines.
  5844.  
  5845.     RS232 - The technical designation for the serial port structure of the
  5846.          IBM Personal Computer. It is also known as the serial port or the
  5847.          asynchronous communications port.
  5848.  
  5849.     RTS - Request To Send, an RS232 signal.
  5850.  
  5851.     SCRIPT - A script language is a form of (usually) simplistic language
  5852.          that allows you to automate most of your on line tasks without
  5853.          any intervention.
  5854.  
  5855.     SD - Send data, An RS-232 signal, often found represented in a light
  5856.          on the front of your modem. When the light is illuminated your
  5857.          are sending data.
  5858.  
  5859.     SYNCHRONOUS TRANSMISSION - This is a method of transfer more commonly
  5860.          used with mainframe computers where both receiving and
  5861.          transmitting modems run in synchronisation controlled by a clock
  5862.          timer.
  5863.  
  5864.     UPLOADING - Sending data (usually in the form of a computer file) to a
  5865.          remote modem.
  5866.  
  5867.     V21 - Full duplex modem transmission at 300 baud
  5868.  
  5869.  
  5870.  
  5871.  
  5872.     COSWORTH COMMUNICATIONS SOFTWARE - Glossary                     page 89
  5873.     (Appendix 4)
  5874.  
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.     V22 - Half duplex modem transmission at 600 and 1200 baud plus a spare
  5882.          reverse channel at 75 baud.
  5883.  
  5884.     V22bis - Full duplex transmission at 1200 baud and 2400 baud with
  5885.          fallback capabilities to V22.
  5886.  
  5887.     V23 - Full duplex transmission at 1200 baud and receive at 75 baud.
  5888.  
  5889.     V32 - Full duplex transmission at 4800 baud and 9600 baud. Modems
  5890.          following this standard can fall back to 4800 baud during adverse
  5891.          conditions and renegotiate to 9600 baud when conditions improve.
  5892.  
  5893.     V32bis - Full duplex transmission at 7200 baud, 1200 baud and 14400
  5894.          baud.
  5895.  
  5896.     V42 - An error correcting protocol incorporating MNP levels 1, 2, 3
  5897.          and 4.
  5898.  
  5899.     V42bis - An error correcting protocol incorporating MNP levels 2, 3
  5900.          and 4 and LAPM.
  5901.  
  5902.  
  5903.  
  5904.  
  5905.  
  5906.  
  5907.  
  5908.  
  5909.  
  5910.  
  5911.  
  5912.  
  5913.  
  5914.  
  5915.  
  5916.  
  5917.  
  5918.  
  5919.  
  5920.  
  5921.  
  5922.  
  5923.  
  5924.  
  5925.  
  5926.  
  5927.  
  5928.  
  5929.  
  5930.  
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.     COSWORTH COMMUNICATIONS SOFTWARE - Glossary                     page 90
  5939.     (Appendix 4)
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.                                ACKNOWLEDGEMENTS
  5948.  
  5949.     We would like to thank the following people for their assistance in
  5950.     getting COSWORTH off the ground;
  5951.  
  5952.     Roger Gregory, Sysop of FORTH VIEW bulletin board whose chance remark
  5953.     started the whole thing off and whose unlimited patience and
  5954.     generosity has finally paid off with the mention in the docs we
  5955.     promised. (!)
  5956.  
  5957.     Alastair McIntyre, Sysop of ALMAC BBS for doing the sort of things he
  5958.     does best...
  5959.  
  5960.     Paul, John, Peter, Biggles, Graeme, Bill, Steven, Davie, Frank, Tom
  5961.     and Walter for testing it all out.
  5962.  
  5963.                                   TRADEMARKS
  5964.  
  5965.     The following products and trademarks are mentioned in this
  5966.     documentation;
  5967.  
  5968.       Microsoft MS-DOS Version 5.00 is copyright Microsoft Corp 1981-1991.
  5969.  
  5970.       Microsoft Windows is copyright Microsoft Corp 1991.
  5971.  
  5972.       DESQview is a trademark of Quarterdeck Office Systems.
  5973.  
  5974.       4DOS is a registered trademark of and is copyright 1988, 1989,
  5975.       1990, 1991 by JP Software Inc.
  5976.  
  5977.       Turbo Pascal, Turbo Debugger, Turbo Assembler and Turbo Profiler are
  5978.       all copyright and registered trademarks of Borland International
  5979.       Inc.
  5980.  
  5981.       TechnoJock's Turbo Toolkit (tm) is copyright 1989 TechnoJock
  5982.       Software, Inc.
  5983.  
  5984.       DSZ is copyright by Omen Technology INC
  5985.  
  5986.       QEdit Advanced Text Editor is copyright 1985-1991 by SemWare.
  5987.       SemWare and QEdit are reg. trademarks of Applied Systems
  5988.       Technologies.
  5989.  
  5990.       D'Bridge is copyright 1988/1989 by Chris Irwin.
  5991.  
  5992.       PC-Type is copyright 1986 by ButtonWare.
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.  
  6002.  
  6003.  
  6004.     COSWORTH COMMUNICATIONS SOFTWARE - Acknowledgements             page 91
  6005.     (Appendix 5)
  6006.  
  6007.